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PERMUTED INDEX 


gett&ble - NIC form&t host tables from a host 
information file for readnew8(l} and che€knew8(l) 
nohnp - mn a command at low priority (sh only) 
program file including aliases and paths (csh only) 

login, newgrp, read,/ sh, for, case, if, while,:, 
- information file for readnew8(l) and checknewsf 
newsrc - information file for readnewsl 
interface, vp - Ikon 
tm - tapemaster 
ar ~ Archive 
mti - Systeeh MTI-800/ 
tm - tapemaster 1/ 
ip - Disk driver for Interphase 
printer interface, vpc - Systeeh VPC- 

ec - 

ar - Archive 1/ 
st - Driver for Sysgen SC 
vp ~ Ikon 10071- 
id - Disk driver for Adaptec ST- 
mti - Systeeh MTI- 
ss - filog 


indesc, nnden, Inbink, ten -- tell 
getmsage - get information 
vtimes - get information 
fstab static information 
abort - terminate 

abs - integer 
fabs, floor, ceil - 


accept * 


getgroupi - get group 
initgioups - initialise group 
setgronps - set group 
accf S8 - determine 
access - determine 
ac - login 
sa, aecton - system 
aect • execution 
pac ~ printer/plotter 
acet - turn 


sa, 

sin, cos, tan, asin, 
sign^ - change the 
sact -> print current SCCS lie editing 
fortune print a random, hopefully interesting, 
sd - Disk driver for 

adbgen - generate 

swapon - 

add user - procedure for 
swapon - specify 
inetjnaof, inei.netof, inet^toa - Internet 
loc - return the 
arp^ 
arp- 

mailaddr - mail 
physical relationships of screens. 

admin - create and 


. newsrc ~ .. • .. 

. nice, • • .... 

. which - locate a . 

arithmetic on shell variables. 

break, continue, cd, eval, exec, exit, export, . • • 

1). newsrc .. 

1) and checknews(l). . 

10071-5 Multibus Versatec parallel printer. 

1 /2 inch tape drive.... • • 

1/4 inch Streaming Tape Drive. 

1600 multi-terminal interface. 

2 inch tape drive.. « • . , 

2180 SMD Disk Controller. . 

2200 Venatec printer/plot ter and Centronics . • . 
SCom 10 Mb/s Ethernet interface. 

4 inch Streaming Tape Drive. .. . 

4000 (Archive) Tape Controller. • • . .. 

5 Multibus Versatec parallel printer interface. • • . 

506 Disk Controllers. . 

800/1600 multi-terminal interface.* • . 

8530 see serial comunications driver. 

abort - generate a fault. .. 

abort - terminate abruptly with memory image. . . 

about character objects.. 

about resource utilisation. 

about resource utilisation.. • . . 

about the fllesystems. .. 

abruptly with memory image. . .. 

abs - integer absolute value. 

absolute value... 

absolute value, floor, ceiling functions. 

ac - login accounting. 

accept • accept a connection on a socket. 

accept a connection on a socket. 

access - determine accessability of a file. 

access - determine accessibility of file. 

access list... 

access list... 

access list. . .... 

accessability of a file. . • .. 

accessibility of file. * * .. 

accounting... 

accounting. 

accounting file. 

accounting information.. . • .. 

accounting on or off. . 

acet - execution accounting file. 

acet - turn accounting on or off. . 

aceton - system accounting. 

acos, atan, atan2 - trigonometric functions. • « . • 

action for a signal. .. 

activity.. .. 

adage. .... 

Adaptec ST-506 Disk Controllers. ........ 

adb - debugger 

adb script. -... 

adbgen > generate adb script. 

add a swap device for interleaved paging/swapping, 
addbib - create or extend bibliographic database, 
adding new users. ............... 

additional device for paging and swapping. 

address manipulation. /inet_network, inet^makeaddr, 

address of an object.. 

address resolution display and control. 

Address Resolution Protocol. 

addressing description .. 

adduser - procedure for adding new users . 

adjacentscreens ~ notify the window driver of the 

admin ~ create and administer SCCS files. 

administer SCCS files .. 

adventure - an exploration game.. 


gettable(8C) 

new3rc(5) 

nice(l) 

which(l) 

C8h(l) 

«h(i) 

news ref 5) 

ncwsrc(5) 

vp(4S) 

tm(4S) 

ar(4S) 

mtt(4S) 

tm(4S) 

ip(4S) 

vpc(4S) 

ecf4S) 

ar(4S) 

st(4S) 

vp(4S) 

8d(4S) 
mti(4S) 
S8(4S) 
abort(3) 
abortfSF) 
index(3F) 
getra8ag^2) 
vtimesfaC) 
f8tab(5j 
abort(3F) 
absfS) 
ab8(3) 
floor(3M) 
»< 8 ) 
accept(2) 
accept(2) 
acccssfSF) 
acce88(2) 
gctgroups(2) 
initgroup8(3) 
8etgroup8(2) 
acccssfSP) 
access (2) 
*c(8) 

.a(8) 

acct(5) 

pac(8) 

acct(2) 

acctiS) 

acct(2) 

»»( 8 ) 

8in(3M) 

8ignal(3F) 

8act(l) 

fortune(6) 

8d(4S) 

adb(l) 


adbgenfS) 

adbgen(8] 

8wapon(2) 

addbib(l) 

adduse^S) 

swapon(8) 

inet(3N) 

loc(3F) 

arp(8C) 

arp(4P) 

maiiaddt{7) 

addu8ei(8) 

adjacentscreens(l) 

admiii(l) 

admin(l) 

advent ure(6) 
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Permuted Index 


yadviae - jive 
flock - apply or remove aa 
yea - be repetitively 
basename - atrip filename 
biff - mail 
time. 


nnaliai: remove 

which - locate a program file including 
ncwaliaiea - rebuild the data baae for the mail 

aliaaea - 
valloc - 

malloc, free, realloc, calloc, cfree, 
free, realloc, calloc, cfree, alloca - memoxy 
valloc - aligned memoty 
eyacc - modified yacc 
imemteat - atand 
gxteat > atand 
diag - Qeneral-purpoae atand- 
acandir, 
limit: 
renice - 
elae: 

lex - generator of lexical 
error - 

analyte - Virtual UNIX poatmortem craah 

worma - 
rain - 
bed - convert to 
exit - terminate a proceaa after fluahing 

flock - 


number - convert 
he - 

graphica/ openpl, eraae, label, line, circle, 
cpie - fonaai of cpio 
ar- 
ar- 
tar- tape 
ar- 

at - Driver for Syagen SC 4000 ( 
tar-tape 
cpio - copy file 
ranlib - convert 
w - who ta on and what they 
uaera - compact liat of uaen who 
glob: filename expand 
ahift: manipulate 
varaiga - variable 
echo: echo 
echo - echo 

getarg, large - return command line 
expr - evatuate 

getopt, optargi optind - get option letter from 
mout, pow, ged, rpow - multiple preciaion integer 

be - arbitraiy-preciaion 

0 : 


newa - USENET netwoik newa 
expire - remove outdated newa 
inewa - aubmit newa 
poatnewa - aubmit newa 
readnewa - read newa 
recnewa - receive unproceaaed 
recnewa - receive unproceaaed 
aendnewa - aend newa 
uurec - receive proceaaed newa 


advice to paging ayatem. 

adviaoiy lock on an open file. . 

affirmative. .... 

affixea. 

alarm. «... .... 

alarm - execute a aubroutine after a apecified . 

alarm - achedule aignal after apecified time. 

aliaa: ahell macroa... 

aliaaea.... « • . 

aliaaea - aliaaea file for aendmail. • • • .. 

aliaaea and patha (cah only).. .. 

aliuea file. 

aliaaea file for aendmail. 

aligned memory allocator. ... 

alloca - memory allocator.. 

allocator malloc, .. 

allocator. 

allowing much improved error recovery.. 

alone memory teat.. • . . . 

atone teat for the Sun video graphica board. 

alone utility package. 

alphaaort - scan a directory. .. 

alter per-proceaa reaource limitationa. 

alter priority of running proceaaea. 

alternative commanda. 

anatyaia programa... 

analyte - Virtual UNDC poatmortem craah analyier. • • 

analyte and diaperae compiler error meaaagea. 

analyier.. . . « . 

animate worma on a display terminal.. 

anioaated raindropa diaplay.. • 

antique media. ... • . .. 

any pending output.. 

a.eut - aaaembler and link editor output. 

apply or remove an advtaory lock on an open file. 

ar-Archive 1/4 inch Streaming Tape Drive. • • • • . 

ar - archive and library maintainer. 

ar - archive (library) file format.. • • • 

Arabic aumerala to Engliah. 

arbitraiy-preciaion arithmetic language.. 

arc, move, cent, point, linemod, apace, cloaepi - * • « • 

archive. 

Archive 1/4 inch Streaming Tape Drive.. 

archive and library maintainer. 

archive file format.. 

archive (libraiy) file formal. 

Archive) Tape Controller. . 

archiver. . 

archives in and out. 

archives to random libraries. 

are doing... 

are on the ayatem... 

argument liat... 

argument Hat. 

argument liat.. • 

aigumenti.. 

arguments... 

argumenta.. . • . « 

arguments as an expression... 

»rgv. . 

arithmetic, {torn, madd, maub, mutt, mdiv, min, * • * • 

arithmetic - provide drill in number facta.. 

arithmetic language. 

arithmetic on shell variables. 

arp - address resolution display and control. 

arp ' Address Resolution Protocol... 

article, utility files. . . . ;. 

articles. • *. 

articles... 

articles.... 

articles. 

articles via mail. .. 

articles via mail, . 

articles via mail. .. 

articles via mail. 

as - mefiSOOO assembler. 


vadvi8c(2) 

fiock(2) 

ye«(l) , , 

basename(l) 

biff(l) 

alarmf3F) 

alarm(3C) 

cshfl) 

C8h(l) 

aliaae8(3) 

which(l) 

newalia8ea(8) 

alias e8(5) 

valloc(3) 

mallo^3) 

malloc(3) 

valloc(3) 

«y»cc(l) 

imemtest(8a) 

gxtest(8a) 

diag(8s) 

acandir(3) 

cah(l) 

rettice(8) 

c»k(l) 

l«(l) 

analyse(8) 

errDr(l) 

analys^8) 

worm8(6) 

rain(8) 

bcd(6) 

exit(3) 

a.out(5) 

flock(2) 

ai{4S) 

numbei(6) 

be(l) 

plot(3X) 

cpio(5) 

.rf4S) 

tJl) 

cpi«(l) 

rMlib(l) 

w(l) 

users(l) 

cahl) 

€8h(l) 

vararg8(3) 

cah(l) 

echo(l) 

getarg(3F) 

expr(l) 

getopt(3C) 

mp(3X) 

arithmeti€(6) 

bc(l) 

C8h(l) 

arp{8C) 


new8(5) 

expire(8) 

inew8(l) 

poatnew8(l> 

readnewsfl) 

recnew8(l) 

recnew8(8) 

8endnew8(8) 

uurec(8) 

as(l) 
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Permuted hdes 


«xpr - evaluate arguments 
timeseue, dysise - convert date and time to 
getdate - convert time and date from 

ascii ~ map of 
od octal, decimal, hex, 
atof, atoi, atol - convert 
to ASCII, ctime, loc^time, gmtime, 
sin, cos, tan, 
kelp - 
as - mc68000 
a.out - 

setbuf, setbulfer, setlinebuf - 

shutdown - close down the system 
at - execute commands 
nice, nohup - run a command 
sin, cos, tan, asin, acos, 
sin, cos, tan, asin, acos, atan, 

atof, 
atof, atoi, 
interrupt, sigpause- 
rc * command script for 
wait - 

backgammon - the game of 

bg: place job in 
wait: wait for 

banner - print large 
gettytab - terminal configuration data 
hosts - host name data 
networks - network name data 
phones - remote host phone number data 
printcap - printer capability data 
protocols - protocol name data 
servers - inet server data 
services - service name data 
termcap «terminal capability data 
newaliases - rebuild the data 
ttytype - data 

fetch, store, delete, first key, next key - data 
vi - screen oriented (visual) display editor 


bcopy, 

operations. 

Display. 

yes- 

cb - C program 
uptime * show how long system has 
jo, jl, in, yO, yl, yn - 
changing/ random, srandom, initstate, setstate - 

addbib - create or extend 
roffbib - run off 
sort bib - sort 

a bibliography .br lookbib - find references in a 
bibliography, indxbib - make inverted Index to a 

comsat - 
whereis - locate source, 
- find printable sizings in an object, or other 
uuencode,uudecode - encode/decode a 
fread, fwrite - buffered 

bind - 

/ 

bcopy, bemp, bsero, ffs - 
bdemos * demonstrate Sun Monochrome 
strip - remove symbols and relocation 
communication. 


as an expression... 

ASCII, ctime, localtime, gmtime, asetime, • . • . 

ASCII. 

ascii ~ map of ASCII character set. 

ASCII character set. • « .. 

ascii dump... 

ASCII to numbers. 

asetime, timesone, dysise - convert date and time 
asin, acos, atan, atan2 - trigonometric functions. . 

ask for help. 

assembler. .. 

assembler and link editor output. 

assert - program verification.. , . • . 

assign buffering to a stream. . .. 

at - execute commands at a later time. 

at a given time.. 

at a later time.. 

at low priority (sh only). 

atan, atan2 - trigonometric functions. 

atan2 - trigonometric functions. 

atof, atoi, atot > convert ASCII to numbers. • • • 

atoi, atoi - convert ASCII to numbers. 

atoi - convert ASCII to numbers. 

atomically release blocked signals and wait for . • 

auto*reboot and daemons. 

await completion of process. 

awk - pattern scanning and processing language. • 

backgammon. 

backgammon - the game of backgammon. 

background... 

background processes to complete. 

banner print large banner on printer. . 

banner on printer. 

base. 

base... 

base... 

base. 

base. .. 

base... 

base. 

base. ... 

base. 

base for the mail aliases file.. 

base of terminal types by port. 

base subroutines, dbminit, . 

based on ex.. . . . 

basename - strip filename affixes.. 

be - arbitrazy-precision arithmetic language. • • • 

bed - convert to antique media. . . .. 

bemp, biero, ffs ~ bit and byte string operations. . 
bcopy, bemp, bsero, ffs ~ bit and byte string « . • 
bdemos - demonstrate Sun Monochrome Bitmap . 

be repetitively affirmative. 

beautifier... 

been up. . 

bessel functions. .. 

better random number generator; routines for . . 

bg: place job in background.. . « 

bibliographic database... 

bibliographic database. 

bibliographic database. 

bibliography, indxbib - make inverted index to 
bibliography .br lookbib <- find references in a 

biff • mail alarm. 

biff server. . . . .. 

binary, and/or manual for program. 

binary, file, strings. 

binary file for transmission via mail. 

binary input/output. 

bind - bind a name to a socket. 

bind a name to a socket.. 

bin/mail - send or receive mail among users. . . . 

bit and byte string operations.. 

Bitmap Display. ... . 

bits. .... 

bk - line discipline for machine-machine ..... 


expr(l) 

ctimc(3) 

getdatc(3) 

a8cii(7) 

a8cii(7) 

od(l) 

atof(3) 

ctime(3) 

sin(3M) 

help(l) 

m(1) 

a.out(5) 

a88ert(3) 

setbuf(3S) 

*t(i) 

8hutdown(8) 

at(l) 

nicc(l) 

8in(3M) 

8in(3M) 

atof(3) 

atof(3) 

atof(3) 

8igpau8e(2) 

rc(8) 

w*it(l) 

awk(l) 

backgammon(6) 

backgammon(6) 

C8h(l) 

C8h(l) 

banner(6) 

banner(6) 

gettytab(3) 

host 8(5) 

network8(5) 

phone8(5) 

print cap(5) 

protoco{s(5) 

8erverB(5) 

8ervice8(5) 

termcap(5) 

newalia8e8(8) 

ttytype(5) 

dbm(3X) 

vi(l) 

ba8enamf(l) 

bc(l) 

bcd(6) 

b8tring(3) 

b8tring(3) 

bdemo8(6) 

y«(i) 

cb(l) 

uptime(l) 

jO(3M) 

random(3) 

C8h(l) 

adabib(l) 

roffbib(l) 

8ortbib(l) 

indxbib(l) 

indxbib(l) 

bifif(l) 

comsat(8C) 

wherei8(l) 

8trings(l) 

uuencode(lC) 

fread(3S) 

bind(2) 

bind(2) 

binmail(l) 

bstring(3) 

bdemos(6) 

8trip(l) 

bk(4) 
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Permuted fndes 


bw - Squ 
sync - update the anper 
eyac - update super- 
syne - update the super 
update - periodically update the super 
sigblock - 
sigpause - atomically release 
sum - sum and couut 
- stand alone test for the Sun video graphics 
boggle - play the game of 

chittg - the 
reboot - UNIX 
mille - play Mille 
indxbib - make inverted index to a bibliography 
switch: multi-way command 
login, newgrp,/ sh, for, can, if, while,:, 


ft: 


mors, page - 

bw - Sun black and white frame 
fread, fwrite - 
sidio - standard 
setbuf, setbuffer, setlinebuf - assign 
fbio - general properties of frame 
generate a dump of the operating lystem^s profile 

mkned - 
cenfif • 

print out manual pages; find manual information 
mkstr ~ create an error message file 
ttytype - data base of terminal types 
ntohs - convert values between host and network 
bcopy, bcmp^ biero, ffs - bit and 
swab - swap 
bcopy, bcmp, 
cc - 
cpp - the 
cb - 

indent - indent and format 
lint - a 

xstr • extract strings from 
mkstr - create an error message file by massaging 

hypot. 


dc - desk 
cal - display 

syscall - indirect system 
gprof - display 
getuid, getgid - get user or group ID of the 
malioc, free, realloc, 
intro - introduction to system 
Canfield, cfscores - the solitaire card game 

canfield. 
printcap - printer 
termcap - terminal 
oct - Central Data octal serial 
canfield, cfscores - the solitaire 
cribbage - the 

exec, exit, export, login, newgrp, read,/ sh, for, 


catman - create the 
ccat > compress and uncompress files, and 

default: 


them, compact, uncompact. 


sh, for, case, if, while,break, continue, 


black and white frame buffer. . 

block. 

block. 

block. 

block.. • . • 

block signals. 

blocked signals and wait for interrupt. • • . 

blocks in a file... 

board, gxtest . 

boggle. 

boggle - play the game of bog^e. 

book of changes and other cookies. 

bootstrapping procedures. 

Bomes. 

.br lookbib - find references in a bibliography. 

branch.. 

break, continue, cd, eval, exec, exit, export, 

break: exit while/foreach loop. 

breaksw: exit from switch. 

bring job into foreground. 

brk, sbric - change data segment site. • • • . 

browN through a text file. 

bsuncube - view 3-D Sun logo. 

buffer. 

buffered binary input/output. 

buffered input/output package. 

buffering to a stream. 

buffers. 

buffen. kpion -. 

build special file. 

build system configuration files. 

bw - Sun black and white frame buffer. . . . 

by keywords, man .. * « 

by massaging C source. 

by port. .. 

byte order, htoni, htons, ntohl, . 

byte string operations. 

bytes... 

bsero, ffs - bit and byte string operations. • • 

C compiler. 

C language preprocessor. . 

C program beautifier. 

G program source.. • « 

C program verifier. . 

C programs to implement shared strings. • • 

C source. 

cabs - Euclidean distance. 

cal - display calendar. 

calculator,. 

calendar. . 

calendar - reminder service. 

call. 

call graph profile data. 

caller... 

calloc, cfree, alloca - memory allocator. . • . 

calls and error numbers. • • • .. 

canfield. • • • .. 

canfield, cfscores > the solitaire card game • . 

capability data base.. « » . 

capability data base.. 

card. 

card game canfield. 

card game cribbage. . 

case, if, while, ., break, continue, cd, eval, 

case: selector in switch. 

cat - concatenate and display. 

cat files for the manual. 

cat them, compact, uncompaet, . 

catchall clause in switch. 

catman - create the cat files for the manual. • 

cb - C program beautifier.. 

cc - C compiler. • • -. 

ccat - compress and uncompress files, and cat 

cd - change working directory. 

cd: change directory. . 

cd, eval, exec, exit, export, login, newgrp, read,/ 


bw(4S) 

syncfl) 

syncf2) 

sync(8) 

update(8) 

sigblock(2) 

sigpause(2) 

sum(l) 

gxtest(8s) 

boggle(6) 

boggle(6) 

ching(3) 

reboot(8) 

mille(6) 

indxbikl) 

cih(l) 

sh(l) 

3 

brk(2) 

moTt(l) 

bsuncube(6) 

bw(4S) 

fread(3S) 

intro(3S) 

setbuf(3S) 

fbio(4S) 

kgmonffi) 

mkned(8) 

config(8) 

bw(4S| 

man(l) 

mk8ti(i) 

ttytype(S) 

byteorder(3N) 

bstring(S) 

swa^S) 

bstring(3) 

cc(l) 

cpp(l) 

cb(l) 

indent(l) 

lint(l) 

xstr(l) 

mkstril) 

hypot(3M) 

«i(i) 

de(l) 

c*l(l) 

calendai(l) 

syscall(2) 

gprof(l) 

getuid(3F) 

malloc(3) 

intro(2) 

canfield(3) 

canfield(3) 

printca]^5) 

teimca^S) 

oct(4S) 

canfield(3) 

cribbage(3) 

.k(i) 

Clh(l) 

c*t(l) 

catman(8) 

compact(l) 

€Sh(l) 

catman(8) 

cWl) 

cc(l) 

compactfl) 

cd(l) 

€Sh(l) 

•k(i) 
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Permuted Indeg 


ddU. 
f&bs, floor, 

fftbv, floor, ceil - ^.baolute vjJoe, floor, 

oct - 

- Syitccb VPC-2200 Vers&tec printer/plotter jind 
malloc, free, realloc, calloc, 
Canfield, 


cbdir - 
brk, Bbrk - 
cbdir - 
chsb * 
cd: 
cbdir 
ioinil - 

chgrp • 

pasflird - 
cbmod - 
cbmod - 
cbmod, fcbmod - 
nmask; 
cbown - 
cbown, fcbowB - 
cbroot - 
lisnal - 
cdc - 
rename - 
delta - make a delta ( 
set: 
cd - 


cbing tbe book of 
- better random number generator; routinei for 
vi > view a file without 
pipe - create an interprocees communication 
ungetc - push 

/iiucii, iBgrapb, toupper, tolower, toaicii - 
eqncbar - special 
getc, fgetc - get a 
index, rindex, Inblnk, lea - tell about 
getc, getcbar, fgetc, getw - get 
putc, putcbar, fputc, putw - put 
ascii - map of ASCII 
putc, fputc - write a 
tset > establisb terminal 
tr * translate 


snake, snscore - display 


dcbeck - file system directoiy consistency 
icbeck * file aystem storage consistency 
fptype ^ 

fsck - file system consistency 
checknews - 
cbecknr - 
eqn, neqn, 

faitbalt ~ reboot/balt tbe system without 
news network. 

newirc - information file for readnews(i) and 


closepi * graphics/ openpl, erase, label, line, 
isgrapb, touppefi tolower, toascii - character 
default: catchall 
unclean - uucp spool directory 


clii - 


cdc - change the delta commentary of an SCCS «... cdc(l) 
ceil - absolute value, floor, ceiling functions. ...... floor(3M) 

ceiling functions.. . • • ..floor(3M) 

Central Data octal serial card. • • ..oct(4S) 

Centronics printer interface, vpc . . * . ..vpc(4S) 

cfree, alloca ~ memory allocator. .malloc(d) 

cfscores - the solitaire card game canfield.canfield(6) 

eg - Sun color graphics interface.. cg(4S) 

change current working directory...chdir(2) 

change data segment sise...brk(2) 

change default directory.. « chdir(3P) 

change default login shell.. . • • • ch8h(l) 

change directory. ..cshfl^ 

change directory. ..€8h(l) 

change f77 I/O initialisation.. ioinit(3F) 

change group.€hgrp(l) 

change login password.pas8wd(i) 

change mode.chmodfl) 

change mode of a file.. • • chmodiSF) 

change mode of file.chmod(2) 

change or display file creation mask.csh(l) 

change owner. ....chownffll 

change owner and group of a file.. chown(2i 

change root directory.€hroot(2) 

change the action for a signal.8ignal(3F) 

change the delta commentary of an SCCS delta.cdc(l) 

change the name of a file.rename{2) 

change) to an SCCS file.delta(l) 

change value of shell variable.. C8h(l) 

change working directory.cd(l) 

changes and other cookies.. ching(6) 

changing generators, /srandom, initstate, setstate . • . random(3) 

changing it using the vi visual editor... view(l) 

channel. .. . • • • pipe(2} 

character back into input stream.ungetc(3S) 

character classification and conversion macros.ctype(3) 

character definitions for eqn...eqnchar(7) 

character from a logical unit.. . getc(3F) 

character objects. ..index(3F) 

character or integer from stream.getc(3S) 

character or word on a stream... putc(3S) 

character set. ..ascii(7) 

character to a FORTRAN logical unit.patc(3F) 

characteristics for the environment.. t8et(l) 

characters...ti(l) 

chase Try to escape to killer robots.cha8e(6) 

chase game...8nake(6) 

chdir - change current working directory.chdir(2) 

cbdir - change default directoiy.chdir(3F) 

chdir: change directoiy.C8h(l) 

check. * ....dcheck(8) 

check...iche€k(8) 

check a floating point number..fptype(3F) 

check and interactive repair.. . f8ck(8) 

check if user has news on the USENET news network. . checknew8(l) 

check nroff/troff files.checknr(l) 

checkeq - typeset mathematics.equ(l) 

checking the disks, fast boot, ..* fa8tboot(8) 

checknews - check if user has news on the USENET . . checknew8(l) 

checknews(l). ..newsrc(5) 

checknr - check nroff/troff files. .checknr(l) 

chgrp - change group.. . chgrp(l) 

ching - the book of changes and other cookies.ching(6) 

chmod - change mode. ...chmod(l) 

chmod • change mode of a file. ..chmod(3F) 

chmod, fchmod - change mode of file.chmod(2) 

chown - change owner. . ... . chown(8) 

chown, fchown - change owner and group of a file. . • . chown(2) 

chroot - change root directory.. . chroot(2) 

chsh ~ change default login shell.ch3h(l) 

circle, arc, move, cont, point, linemod, space, .plot(3X) 

classification and conversion macros, /isascii, .ctype(3) 

clause in switch. ..C8h(l) 

clean-up. . . , c ...uucIeaD(8C) 

clear - cleat workstation or terminal screen.clear(l) 

clear i-node...clri(8) 


Sun System Release 1.1 


- V - 


January 1984 









































































PtrmuUi Init9 


clear- 
ferror» fcof, 

csli - a shell (command interpreter) with 

cron - 

shutdown - 
fclose, fllnsh - 

opendir, readdir, telldir, seekdir, rewinddir, 
syslofi openlof, 
circle, arc, move, cont, point, linemod, space, 


pi - Pascal intcrpmter 


log. dmesf- 
colerdemoi - demonstrate Son 
cf - Snn 
Displax* 

pr - print file(s), possibly in mnitiple 
coirm - remove 

comb - 
files. 

exec overlay shell with specified 
time: time 

- rontines for tetnming a stream to a remote 
rexec - retnm stream to a remote 
system * issne a shell 
system - execute a UNIX 
test - condition 
time - time a 
nice, nohnp - mn a 
switch: mniti-way 
nnx - nnix to nnix 
rehash: recompute 
unhash: discard 
hashstat: print 
nohup: run 
csh - a shell ( 
what is - describe what a 
readonly, set, shift, times, trap, umask, wait - 
getarg, iaigc - return 
repeat: execute 
rc- 

onintr: process interrupts in 
goto: 

else: alternative 
intro - introduction to 
- introduction to system maintenance and operation 

at - execute 
while: repeat 
lasteomm - show last 
source: read 
cdc - change the delta 
comm - select or reject lines 
bk - line discipline for machine-machine 
socket - create an endpoint for 
pipe - create an interprocess 
users - 
files, and cat them, 
diff - differential file and directory 
cmp - 
sccsdiff - 

difffi - 3-way differential file 
intro - introduction to 
cc - C 

m - FORTRAN-77 
pc - Pascal 
yacc - yet another compiler- 
error - analyse and disperse 
yacc - yet another 
wait: wait for background processes to 
wait - await 
compact, uncompact, ccat - 


clear workstation or terminal screen.. . 

clearerr, fileno - stream status inquiries.. 

C-like syntax. 

clock daemon. 

close - delete a descriptor.. 

close down the sjrstem at a given time. . 

close or flush a stream. 

closedir - directory operations. 

closelog - control system log. 

closepl - graphics interface, /erase, label, line. 

ciri - clear i-node... 

cmp - compare two files. 

code translator.... • • 

col - filter reverse paper motions.. • * . • 

colcrt - filter nroff output for CRT previewing. • • « • 
collect system diagnostic messages to form error » « • • 

Color Graphics Display. 

color graphics interface.. • .. 

colordemos - demonstrate Sun Color Graphics. 

coirm - remove columns from a file. . 

columns..... 

columns from a file.. 

comb - combine SCCS deltas.. • • • • 

combine SCCS deltas. 

comm - select or reject lines common to two sorted « • * 

command... 

command. 

command, rcmd, rresvport, ruserok .. • 

command.... 

command.... 

command. 

command. • • .. 

command. • « .. 

command at low priority (sh only).. • « 

command branch.. » 

command execution. 

command huh table. 

command huh table. .. 

command huhing statistics. • ... • • • • 

command immune to hangups. 

command interpreter) with C-like sjmtax. 

command is. • • .... 

command language, /export, login, newgrp, read, • • « 

command line arguments. 

command repeat^ly.... • • 

command script for auto-reboot and dumons. • « • • • 

command scripts.. 

command transfer. ... 

commands. ..... 

commands. . .... 

commands, intro .. 

commands at a later time. • • .. 

commands conditionally. • • . • ... « , , 

commands executed in revene order. . 

commands from file. • • • • ... • • • . 

commentary of an SCCS delta, o ••*••••••• • 

common to two sotted files. .. 

communication... 

communication. 

communication channel.. • • • 

compact list of users who are on the system. 

compact, uncompact, ccat - compress and uncompress 

comparator... 

compare two files.. 

compare two versions of an SCCS file. 

comparison. • .. 

compatibility library functions. 

compiler. . . .. 

compiler. .. . .. 

compiler. .. , , 

compiler. .. 

compiler error messages.. 

compiler-compiler. 

complete... 

completion of process. 

compress and uncompress files, and cat them. 


clear(l) 

ferror(3S) 

C8h(l) 

cron(8) 

clo8e(2) 

shutdowtt(8) 

fclose(3S) 

director7\3) 

sy8log(3) 

plot(3X) 

clri(8) 

cm^l) 

€olcrt(l) 

dmes^8) 

colordemo8(6) 

cg(4S) 

colordemo8(6) 

€olrm(l) 

colnnil) 

combfl) 

€omb(l) 

comnul) 

rcmd(3N| 

rexec(3N) 

sy8temf3) 

systemfSP) 

tert(l) 

tim^l) 

nice(l) 

c.h(l) 

uux(lC) 

csh(l) 

csh(l) 

csh(ii 

csh(l) 

csh(l) 

whatis(l) 

Clfc(l) 

r^8) 

csh(l) 



intro 
intro 
at(l)' 

C8h(l) 

lastco]iu&(l) 

€8h(l) 

cdc(l) 

comnul) 

Wc(4) 

iocket(2) 

P'P«(2) 

«i«n(l) 

coap»^l) 

cmp(l) 

iccsdill(l) 

diff3(l) 

iiktro(3C) 

cc(l) 

n7(i) 

y*cc(l) 

enoift) 

y»cc(l) 

csk(l) 

compftct(l) 
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PermuUd Indes 


ha&gmaa ^ 

18 - files 8530 see seriail 
cat - 
test - 
endif: tenninate 

if: 

while: repeat commands 

settytab -> termini 
confis - bnild system 
ifeonfig - 

tip, cn - 

getpeername ~ get name of 
socketpair - create a pair of 
shutdown ** shut down part of a full-duplex 
accept - accept a 
connect - initiate a 
listen - listen for 


dcheck file system directory 
icheck - file system storage 
fsck • file system 
cons • driver for Sun 
mkfs - 
newfs - 
mkproto - 

deroff - remove nroff, troff, tbl and eqn 
setilimit * control maximum system resource 
vlimit ^ control maximum system resource 
openpl, erase, label, line, circle, arc, move, 

is - list 

sigstack - set and/or get signal stack 
lockscreen * maintain window 
newgrp,/ sh, for, case, if, while,:, break. 


arp - address resolution display and 
fenti - file 
nd - network disk 
ioctl - 
init - process 
getriimit, setrlimit - 
vlimit - 
iemp - Internet 
dkio - generic disk 
fentI - file 
ipe - line printer 
tep - Internet Transmission 
syslog, openlog, closelog - 
vhangup - virtually hangup** the current 
ip - Disk driver for Interphase 2180 SMD Disk 
ft - Driver for Sysgen SC 4000 (Archive) Tape 
sd r Disk driver for Adaptec ST-605 Disk 
xy - Disk driver for Xylogics SMD Disk 
ecvt, fevt, gevt - output 
printf, fprintf, sprintf - formatted output 
scanf, fscanf, sscanf - formatted input 
tolower, toascii - character classification and 

units - 
vswap *- 
dd- 
number > 
ranlib - 
atof, atoi, atol - 
localtime, gmtime, asetime, timesone, dysise - 

htable - 
getdate - 
bed- 

htoni, htons, ntohl, ntohs - 
ching - the book of changes and other 
rep - remote file 
UUCP, uutog - Unix to unix 
. dd - convert and 
cpio - 
cp- 


Computer version of the game hangman. 

comsat - biff server. .. 

comunications driver. 

concatenate and display. .. . . , . 

condition command.. . . • 

conditional... 

conditional statement. « .. 

conditionally. . 

config - build system configuration files. 

configuration data base. 

configuration files. 

configure network interface parameters.. 

connect - initiate a connection on a socket. . . . 

connect to a remote system. 

connected peer.. 

connected sockets. 

connection. .. 

connection on a socket. 

connection on a socket. • .. 

connections on a socket. 

cons - driver for Sun console. 

consistency check. 

consistency check. 

consistency check and interactive repair. • • » • 

console... 

construct a file system. 

construct a new file system. 

construct a prototype file system. 

constructs. . « • ..* « 

consumption, getriimit... 

consumption. 

cont, point, linemod, space, ctosepi - graphics/ . • 

contents of directoiy. 

context... 

context until *1ogia’'. 

continue, cd, eval, exec, exit, export, login, . . . 

continue: cycle in loop.. . • 

control... 

control. • • • .... 

control... 

control device. 

control initialiiation. 

control maximum system resource consumption, 
control maximum system resource consumption. 

Control Message Protocol. 

control operations. 

control options. .. 

control program.*. 

Control Protocol. ... 

control system log. 

control terminal. 

Controller. . 

Controller. .. 

Controllers... 

Controllers. 

conversion. .. 

conversion. 

conversion... 

conversion macros, /isascii, isgraph, toupper, . . 

conversion program.. 

convert a foreign font file... 

convert and copy a file. 

convert Arabic numerals to English. ...... 

convert archives to random libraries. ...... 

convert ASCII to numbers. 

convert date and time to ASCII, ctime,. 

convert NIC standard format host tables. 

convert time and date from ASCII. 

convert to antique media.. 

convert values between host and network byte order. 

cookies. • .... 

copy... 

copy... 

copy a file. • * .... 

copy file archives in and out. 

copy files. 


hangman(6) 

com8at(8C) 

S8(4S) 

cat(l) 

tcst(l) 

C8h(l) 

C8h(l) 

C8h(l) 

config{8) 

gettytab(5) 

config(8) 

ifconfig(8C) 

connect(2) 

tip(lC) 

getpeemame(2) 

80 cketpaiif 2 ) 

shutdown(2) 

accept(2) 

connect(2) 

li8ten(2) 

con8(4S) 

dcheck(8) 

icheck(8) 

f8ck(8) 

con8(4S) 

mkfs(8) 

newf8(8) 

mkproto(8) 

dero^l) 

getriimit(2) 

vlimit(3C) 

plot(3X) 

l8(l) 

8ig8tack(2) 

lockscreen(l) 

8h(l) 

C8h(l) 

arp(8C) 

fcntl(2) 

nd(8C) 

ioctl(2) 

init(8) 

geti1imit(2) 

vlimit(3C) 

icmp(4P) 

dkio(4S) 

fcntl(5) 

Ipc(8) 

tcp(4P) 

8y8log(3) 

vhangup(2) 

ip(4S) 

8t(4S) 

8d(4S) 

xy(4S) 

ecvt(3) 

printf(3S) 

8canf(3S) 

ctype(3) 

units(l) 

V8wap(l) 

dd(l) 

number(6) 

ranlib(l) 

atof(3) 

ctime(3) 

htable(8) 

getdate(3) 

bcd(6) 

byteordcr(3N) 

€hing(6) 

rcp(lC) 

uucp(lC) 

dd(l) 

cpio(l) 

cp(l) 
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PtrmuUd Index 


fork - create a copy of this procese.fork(SF) 

ice - copy etanda^ oaipnt to many files. 

core - format of memoiy ima^ file.core(5) 

savecore - save a core dump of tke operating system,. •avecore(8) 

gcore - get core images of raaning processes...gcore(l) 

fsync - synckroaiie a file's ia- core state witk that oa disk.. f8yac(2) 

fanctioai. sia, cos, tan, asia, acos, ataa, ataa2 - irigoaometric ... * iia(3M) 

sink, cosh, taah - hyperbolic functions.sinh(3M) 

wc - word count... 

sum - sum and count blocks ia a file.sum(l) 

cp - copy files.€p(t) 

cpio - copy file archives ia and out.. « « cpiofl) 

cpio - format of cpio archive.cpio(3) 

cpio * format of cpio archive.*.cpio(5) 

epp ~ the C language preprocessor. .cpp(l) 

crash - what happens whn the system crashce.cra8h{88) 

aaatyn - Virtual UNIX postmortem erwh analyser.aaaiyse(8) 

crash - what happens when the system crashes.cra8h(88) 

creat - create a new file. • • . ... • • creat(2) 

fork - create a copy of this process.. • foric(3F) 

tmpaam- create a name for a temporary file.. • • • • impnam(3C) 

creat - create a new file.creat(2) 

open ' open a file for reading or writing, or create a new file.. opea(2) 

fork - create a new process.fork(2) 

socketpair - create a pair of connected sockets.iocketpaii(2) 

ctap - create a tags file. 

socket - create an endpoint for communication.socket(2) 

mkstr - create an error message file by massaging C source. • • . mkstift) 

pipe - create an interprocess communication channel.pip«(2) 

admin - create and administer SCCS files.admin(l) 

addbib - create or extend bibliographic database.addbil^l) 

catman create the cat files for the manual.catman(8) 

umask: change or display file creation mask.csh(l) 

umask - set file creation mode mask.umask(2) 

cribbage - the card game cribbage.cribba^fi) 

cribbage ~ the card game cribbage.cribbage(0) 

cron - clock daemon.cron(8) 

cront&b ~ iftbte of times to rum periodic jobs.crontmb(5) 

pxref- Pascal cross«reference program...pxref{l) 

colcrt - filter nrof output for CRT previewing..colcrt(l) 

ciypt - encode/decode. cryptfl) 

crypt, set key, encrypt - DES encryption.crypt (3) 

syntax, esh - a shell (command interpreter) with C-like ... * csb(l} 

locate a program file including aliases and paths ( esh only), which - .which(l) 

ctags - create a tags file.ctag8(l) 

- convert date and time to ASCII, ctime, localtime, gmtime, asetime, timeione, dysise . • • ctime(3) 

tip, cu - connect to a remote system.tip(lC) 

vhangup - virtually ''hangup" the current control terminal.vhangup(2) 

gethostid - get unique identifier of current host.gethostid(2) 

gethost name, set hostname- get/set name of current host. gethoBtname(2) 

hostnm - get name of current host.hostam(3F) 

hostid - print identifier of current host system.hostid(l) 

hostname - set or print name of current host system.hostnamo(l) 

jobs: print current job list.csh(l) 

sun - is current machine a sun workstation.sun(l) 

vax - is current machine a vax...vax(l) 

sact - print current SCCS file editing activity.. « • « sact(l) 

sigsetmuk - set current signal muk.. sigsetmask(2) 

wheami - display effective current username...whoami(l) 

chdir - change current working directory..chdir(2) 

getewd - get pathname of current working directory.getcwd(3F) 

getwd - get current working directory pathname. .getwd(3) 

motion, curses - screen functions with "optimal" cursor • • . • cursesffiX) 

curses - screen functions with "optimal" cursor motion.curses^SX) 

spline - interpolate smooth curve...spline(lG) 

continue: cycle in loop...C8h(l) 

bsuncube - view 3- D Sun logo...b8uncube(6) 

cron - clock daemon.* • • « cron(8) 

inetd - internet services daemon.inetd(8C) 

Ipd - line printer daemon. . ..Ipd(8) 

routed - network routing daemon....routed(8C) 

rc - command script for auto-reboot and daemons. .rc(8) 

ftpd - DARPA Internet File Transfer Protocol server.ftpd(8C) 

telnetd - DARPA TELNET protocol senrer. .telnetd(8C) 

timed- DARPA Time server.* timed(8C) 

tftpd - DARPA Trivial File Transfer Protocol server. . , • • . tftpd(8C) 
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Permuted Index 


«▼&!: re-ev&laate shell 
Kprof - display call paph profile 
piof - display profile 
ttys - terminal initialiiation 
geitytab - terminal eonfienration 
hosts - host name 
networks - network name 
phones * remote host phone number 
printcap * printer capability 
protocols - protocol name 
servers - inet server 
services - service name 
teimcap - terminal capability 
newaliases - rebuild the 
ttytype - 

dbminit, fetch, store, delete, first key, next key - 

oct - Central 
brk, sbrk - change 
null * 

types - primitive system 
addbib - create or extend bibliographic 
roffbib - run off bibliographic 
sortbib - sort bibliographic 
join - relational 
udp Internet User 
date - display or set the 

gettimeofday, settimeofday - get/set 
time, ftime - get 
gmtime, aictime, timesone, dysiie - convert 
rdate - set system 
getdate - convert time and 
touch - update 
idate, itime - return 
data base subroutines. 


adb - 
dbx - 
od - octal, 

tp- 

crypt - encode/ 
uueneode,ttudecode - encode/ 

chdir - change 
chsh - change 

kbd - keyboard translation table format and 
eqnehar - special character 
close - 

dbminit, fetch, store, 
ede * change the delta commentary of an SCCS 


delta - make a 
ede - change the 
rmdel - remove a 
comb - combine SCCS 
colordemoB - 
bdemos - 
mesg - permit or 
constructs, 
crypt, setkey, encrypt - 
whatis - 

mailaddr - mail addressing 
remote - remote host 
close - delete a 
dap, dap2 - duplicate a 
getfstype, setfsent, endfsent - get file system 
getfd - get the file 
getdtablesise - get 
dc- 
access - 
access - 
file - 

drum - paging 


data. * • • .. 

data. 

data.. • 

data. 

data base.. . , 

data base. ... 

data base... 

data base. • • . ..* • 

data base. ... . • . « 

data base. 

data base.. 

data base.*.. 

data base. 

data base for the mail aliases file. 

data base of terminal types by port. 

data base subroutines. 

Data octal serial card.. 

data segment sise. 

data sink.. .. 

data types. 

database... 

database.. * . • 

database. • • .. 

database operator. . 

Datagram Protocol. .. 

date. 

date - display or set the date. .. 

date and time. . 

date and time. 

date and time to ASCII, ctime, localtime, • • 

date from a remote host. • • • .. 

date from ASCII..... 

date last modified of a file. 

date or time in numerical form. .. 

dbminit, fetch, store, delete, firstkey, nextkey - 

dbx - debugger. 

dc - desk calculator. . 

dcheck - file system directory consistency check. 

dd • convert and copy a file. 

debugger. «... .. . 

debugger. • • .. 

decimiJ, hex, ascii dump. . • • .. 

DEC/mag tape formats. 

decode.* « • • • 

decode a binary file for transmission via mail. 

default: catchall clause in switch. 

default directory. « . .. 

default login shell. 

default table. 

definitions for eqn. 

delete a descriptor. • . • .. 

delete, firstkey, nextkey - data base subroutines. 

delta. . « . • .. 

delta - make a delta (change) to an SCCS file. 

delta (change) to an SCCS file. 

delta commentary of an SCCS delta. 

delta from an SCCS file. • • • .. 

deltas.. • « .. 

demonstrate Sun Color Graphics Display. <. • 
demonstrate Sun Monochrome Bitmap Display. 

deny messages... 

deroff - remove nroff, troff, tbl and eqn . « • 

DES encryption. 

describe what a command is. 

description. 

description file. 

descriptor.. 

descriptor.. 

descriptor file entry, /getfsspec, getfsfile, • . 
descriptor of an external unit number. • • . 

descriptor table sise. 

desk calculator. « * .. 

determine accessabitity of a file. 

determine accessibility of file. 

determine file type. 

device... 


C8h(l) 

gprof(l) 

prof(l) 

ttyg(S) 

gettytab(5) 

h08t8(5) 

network8(5) 

phone8(5) 

printcap(5) 

protocol8(5) 

8erven(5) 

8eiYice8(5) 

termcap(5) 

newalia8e8(8) 

ttytype(6) 

dbm(3X) 

oct(4S) 

brk(2) 

null(4) 

type8(6) 

addbib(l) 

roffbib(l) 

sortbil^l) 

join(l) 

udp(4P) 

dateil) 

date(l) 

gettimeofday(2) 

time(3C) 

ctime(3) 

rdate(8) 

getdate(3) 

touch(l) 

idate(dF) 

dbm(3X) 

dbx(l) 

dc(l) 

dcheck(8) 

dd(i) 

•dMl) 

dbx(l) 

odd) 

tp(6) 

crypt(l) 

uuencode(lC) 

C8h(l) 

chdir(3F) 

ch8h(l) 

kbd(5) 

eqnchar(7) 

clo8e(2) 

dbm(3X) 

cdc(l) 

delta(l) 

delta(l) 

cdc(l) 

nndel(l) 

comb(i) 

colordemo8(6) 

bdemo8(6) 

mc8g(l) 

dero^l) 

crypt(3) 

what 18 ( 1 ) 

mailaddr(7) 

remote(3) 

clo8e(2) 

dup(2) 

getf8ent(3) 

getfd(3F) 

getdtable8ize(2) 

dc(l) 

acccs8(3F) 

access(2) 

file(l) 

drum(4) 
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Permuted Indes 


fold - fold tong lines for Enite width output 
iocti - control 
swnpon - ndd n swnp 
iwnpon * specify addition^ 

Emin, flmix, dEmin, 
Emin, flmix, 
package, 
dmesg - collect system 
ntfor - rntional Foitmn 


dif- 
dif3 - 8-w*y 


dir - fennnt of 
' nii» nndir - remove («nlink) Eles or 
rmdtr, rm * remove (nnlink) 
cd - change working 
chdir - change current working 
chdir - change default 
chroot - change root 
cd:change 
chdir change 

getcwd - get pathname of current working 
Is - list contents of 
mkdir- make a 
scandir, aiphasoit - scan a 
unclean - uucp spool 
diff - differential file and 
dcheck - file system 
unlink - remove 
unlink - remove a 
mkdir - make a 
nadir - remove a 
pwd * print working 
leaddirt telldiri leekdir, rewinddir, cloiedir - 
getwd - get cniTcnt working 
popd: pop shell 
pushd: push shell 
setquota - enable/ 
unhash: 

unset: 
bk - line 

synchronise a file’s in-core state with that on 

nd - network 
dkio - generic 
ip - Disk driver for Interphase 2180 SMD 
sd - Disk driver for Adaptec ST-508 
xy - Disk driver for Xylogics SMD 
nd - network 
sd - 

Controller ip- 

xy- 

quota - manipulate 
df - repoit free 
dn - summarise 
- reboot/halt the system without cheeking the 
mount, umount - mount and 
error - analyse and 
bdemos - demonstrate Sun Monochrome Bitmap 
cat - concatenate and 
colordemos - demonstrate Sun Color Graphics 
rain - animated raindrops 
arp - address resolution 
cal- 
gprof- 
snake, snscore - 
vi - screen oriented (visual) 
whoami - 
umask: change or 
head - 

peifmon - graphical 
date - 
prof - 

worms - animate worms on a 


device. . • . .... 

device. .. 

device for interleaved paging/swapping.. 

device for paging and swapping. . .. 

df - report free disk space on file systems. 

dfimax, inmax - return extreme values. 

dfimin, dflmax, inmax - return extreme values. • • • . 
diag - General-purpose stand-alone utility 

diagnostic messages to form error log.. 

dialect.... . • 

diff - differential file and directory comparator.. 

diffS- 8-way differential file comparison.. • 

differential file and directory comparator. 

differential file comparison. * • .. 

dir - format of directories. * • ... . 

directories. . . . .. 

directories... 

directories or files. *. 

directory... 

directory. • *.. • • • • « • • 

directory.. 

directory. • « • « ..... « • • • 

directory... 

directory. 

directory. 

directory... 

directory. .. 

directory. • • .. 

directory dean-up. . 

directory comparator.. 

directory consistency check. 

directory entry. • . • • ... 

directory entry... 

directory file.... 

directory file.. • • • « 

directory name. .. 

directory operations, opendir, . 

directory pathname. 

directory Stack. 

directory stack.. 

disable quotas on a file system.. • • 

discard command hash table.. 

discard shell variables. 

discipline for machine-machine communication. 

disk, fsync .*. 

disk control. • .. 

disk control operations. 

Disk Controller. .. • • 

Disk Controllers. .. 

Disk Controllers. 

disk driver. 

Disk driver for Adaptec ST-508 Disk Controllers. 

Disk driver for Interphase 2180 SMD Disk. 

Disk driver for Xylogics SMD Disk Controllers. 

disk quotas. 

disk space on file systems... 

disk usage. • « .. 

disks, fastboot, fasthalt • • • • *.. • 

dismount file system. 

disperse compiler error messages. 

Display. 

display. 

Display. 

display. 

display and control. 

display calendar. .. 

display call graph profile data. • * • ... . 

display chase game. 

display editor based on ex. 

display effective current username.. * . 

display file creation mask.. « « 

display first few lines of specified files.. • * • 

display of general system statistics. 

display or set the date. 

display profile data. 

display terminal. .. 


fold(l) 

ioctl(2) 

8waponf2) 

•wapon(8) 

df(i) 

rangefSF) 
range(3F) 
dia^Ss) 
dme8g(8) 
ratfo^l) 
diff(l) 
diff3(l) 
diff(l) 
Iiff3(l) 
UxfS) 
t(5) 


rmdir(l) 

cd(l) 

chdirf2) 

ehdir(dF) 

chroot{2) 

eWn 

csh(l) 

getcwd(3F) 

Hi) 

mkdit(l) 

icandir(3) 

uuclean(8C) 

diff(l) 

dcheck(8) 

Uttlittk(2) 

unlink(3F) 

mkdir(2) 

rmdtr(2) 

pwd(l) 

directory(3) 

getwd(3) 

cshfl) 

CSh(l5 

sctquota(2) 

cshfl) 

C8h(l) 

bk(4) 

fsynq2) 

nd(8C) 

dkio(4S) 


sd(4S: 
xyUs) 
nd(4P) 

8d(4S) 

•p(4S) 

xj<4S) 

quota(2) 

df(l) 

du(l) 

fastbootf8) 

mount(8) 

errorfl) 

bdemo^8) 

cat(l) 

colordemos(6) 

raia(8) 

arp(8C) 

e*l(l) 

gprof(l) 

snake(8) 

vi(l) 

whoami(l) 


head(l) 

perfmon(l) 

date(l) 

prof(l) 

worm8(6) 
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Permuted Index 


tail - 

hypot, cabs - Euclidean 
error 

refer - find and insert literature references in 
troff - typeset or format 
w - wbo is on and wbat they are 
shutdown ~ shut 
shutdown - close 

graph - 

draw - interactive graphics 
arithmetic - provide 
ar - Archive 1/4 inch Streaming Tape 
tm - tapemaster 1/2 inch tape 
fid - network disk 
pty - pseudo terminal 
IS « silog 8530 SCO serial comunications 

sd ~ Disk 
ip - Disk 
cons - 
Controller, st - 
xy - Disk 

adjacentscrsens - notify the window 
term - terminal 
term - terminal 


dump - incremental file system 
od - octal, decimal, hex, ascii 


dumpfs - 

dump, dumpdates - incremental 
savecore - save a core 
kgmon - generate a 
dump, 


dup, 

shutdown - shut down pari of a full- 
dup, dup2 - 

ctim®, localtime, gmtime, asctime. timeione, 


echo: 

echo- 


end, etext, 
«x, 
vipw - 

sact - print current SCCS file 
ed - text 
ex, edit - text 
Id - link 
sed - stream 

view a file without changing it using the vi visual 
vi • screen oriented (visual) display 
a.out - assembler and link 
whoami - display 
setregid - set real and 
setreuid - set real and 
vfork - spawn new process in a virtual memory 

fircp. 

insque, remqne - inseit/remove 
soelim - 

tektool - Tektronix 4014 terminal 

setquota - 
uuencode - format of an 
crypt- 

mail, uuencode,uudecode- 
crypt, setkey, 


display the last part of a file.. 

distance.. . 

dkio - generic disk control operations. 

dmesg - collect system diagnostic messages to form 

documents. 

documents. 

doing... 

down part of a full-duplex connection. . • . • « 

down the system at a given time. 

draw - interactive graphics drawing. 

draw a graph. 

drawing. 

drill in number facts. 

Drive. 

drive. 

driver. . 

driver. . « . . .. 

driver. .. 

driver for Adaptec ST-503 Disk Controllers. • . , 
driver for Interphase 2180 SMD Disk Controller. 

driver for Sun console. 

Driver for Sysgen SC 4000 (Archive) Tape . . . . 

driver for Xytogics SMD Disk Controllers. 

driver of the physical relationships of screens. • . 

driving tables for nroff. . .. 

driving tables for nroff. . 

drum - paging device. 

du - summariie disk usage. . 

dump... 

dump. 

dump - incremental file system dump. . 

dump, dumpdates - incremental dump format. . . 

dump file system information. 

dump format. .. 

dump of the operating system.. . 

dump of the operating system’s profile buffers. » « 

dumpdates - incremental dump format. 

dumpfs - dump file system information. 

dup, dup2 - duplicate a descriptor. 

dup2 - duplicate a descriptor. 

duplex connection. 

duplicate a descriptor. . 

dysiie - convert date and time to ASCII. 

ee <- 3Com 10 Mb/s Ethernet interface. 

echo - echo arguments. • . . .. 

echo arguments. 

echo arguments. 

echo: echo arguments. 

ccvt, fcvt, gcvt - output conversion. 

ed - text editor. . 

edata - last locations in program. 

edit - text editor. 

edit the password file.. 

editing activity. 

editor. 

editor. * . • .. 

editor.. 

editor. 

editor, vi - . 

editor based on ex.. • . . 

editor output. 

effective current username.. . 

effective group ID. 

effective user ID’s. 

efficient way... 

egrep, fgrep - search a file for a pattern. 

element from a queue. 

eliminate .so's from nroff input. 

else: alternative commands. 

emulator tool. .. 

en - Sun 3 Mb/s experimental Ethernet interface. 

enable/disable quotas on a file system. 

encoded uuencode file. 

cncode/decode.. 

encode/decode a binary file for transmission via 
encrypt - DBS encryption. 


tail(l) 

hypot(3M) 

dkio(4S) 

dme8g(8) 

refer(l) 

troff(l) 

w(l) 

8hutdown(2) 

shutdown(8) 

draw(6) 

graph(lG) 

draw(6) 

arithmetic(3) 

.r(4S) 

tm(4S) 

l»d(4P) 

ig(4S) 

ld(4S) 

ip(4S) 

con8(4S) 

st(4S) 

xy(4S) 

ad jacentscreen8( 1) 

,term(5) 

term(5) 

drum(4) 

du(l) 

dump(8] 

odd) 

dump(8) 

dump(5) 

dumph(8) 

dnmp(5) 

savecore(8) 

kgmon(8) 

dump(5) 

dumpf8(8) 

dup(2) 

dup(2) 

8hutdown(2) 

dup(2) 

ctime(3) 

«c(4S) 

echo(l) 

C8h(l) 

echo(l) 

C8h(l) 

ccvt(3) 

ed(l) 

end(3) 

«x(l) 

vipw(8) 

8act(l) 

ed(l) 

«( 1 ) 

ld(l) 

8ed(l) 

view{l) 

vi(l) 

a.out(5) 

whoami(l) 

8etregid(2) 

8etreuid(2) 

vfork(2) 

Krep(l) 

insque(3) 

8oeHm(l) 

C8h(l) 

tektool(l) 

cn(4S) 

8etquota(2) 

uuencode(5) 

crypt(l) 

uuenco(Ie(lC) 

crypt(3) 
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Permuted Index 


ciypi, Mtkey, cnciypt - DES 
m&kekey - generate 

8CCS - front 
logont: 

/getfiipec, getfsfile, getfitype, letfaent, 
getgrent, getgrgid, getgmam, setgrent, 
getkoftbyaddr, getkoftbyname, lethoatent, 

getnetent, getnetbyaddr, getnetbyname, letnetent, 

iocket > create an 
getprotobynnmber, getprotobyname, eetprotoent, 
getpwent, getpwnid, getpwnam, letpwent, 
geteervbyport, getiervbyname, tetieirent, 

number - convert Arabic numerate to 
xeend, xget, 
nliet - get 

endfeent - get file eyetem deicriptor file 
getgmam, letgrent, endgrent - get group file 
eethoitent, endboetent - get network hoet 
getnetbyname, eetnetent, endnetent - get network 
setprotoent, endprotoent - get protocol 
getpwnam, letpwent, endpwent - get paiiword file 
eetierrent, endiervent - get lervice 
eyilog - make eyetem log 
unlink - remove directory 
unlink - remove a directory 
execi, execv, execle, execlp, execvp, 

eetenv: let variable in 
environ - user 
printenv - print out the 
euntoole - the Suntoole window 
tiet - eetabliih terminal characteiietici for the 
getenv - value for 
uneetenv: remove 
getenv - get value of 
eqnchar - epecial character definitione for 
deroff - remove nroff, troff, tbl and 


linemod, epace, cloeepl - graphice/ openpl, 
perror, eye^errliet, iye_nerr, 
meeeagee. 

dmeeg - collect eyetem diagnoetic meeeagee to form 

mkitr - create an 
error - analyte and diiperee compiler 
perror, eyejerriiet, eye.nerr, ermo - eyetem 
perror, gerror, iermo - get eyetem 
intro - introduction to eyetem calle and 
eyacc - modified yacc allowing much improved 
epell, epelltn, epellout - find epelling 
chaie - Try to 
environment, teet- 
end, 

ec - aCom 10 Mb/e 
en - Sun 0 Mb/e experimental 
hypot, cabe - 

for, caee, if, while,:,., break, continue, cd, 

expr- 
eval: re- 
histoiy: print hietory 
- screen oriented (visual) display editor based on 

Ipq ~ spool queue 
/case, if, while, break, continue, cd, eval, 

execute a file, 
exed, execv, 
excel, execv, execle, 
sticky - 

excel, execv, execle, execlp, execvp, environ - 

exeeve - 


encryption. 

encryption key. 

end, etext, edata - last locations in program. 

end for the .SM SCCS subeyetem. 

end eeeeion. 

end: terminate loop.. • • 

endfeent • get file eyetem descriptor file entry. 

endgrent - get group file entry. 

endhostent - get network hoet entry, gethoetent, « . . 

endif: terminate conditional... 

endnetent - get network entry... 

endpoint for communication.. • 

endprotoent - get protocol entry, getprotoent, • • • • , 

endpwent - get password file entry. 

endeervent > get service entry, geteervent. 

endew: terminate twitch. 

English.. 

enroll - secret mail.. • . 

entries from name list. 

entry, /getfeepec, getfefile, getfitype, eetfeent, • • • . • 

entry, getgrent, getgrgid. 

entry, gethoetent, gethoetbyaddr, gethoetbyname, • • • 

entry, getnetent, getnetbyaddr, . 

entry, /getprotobynnmber, getprotobyname, . • • • • 

entry, getpwent, getpwuid, . . • • 

entry, geteervent, geteervbyport, getservbyname, . • . 

entry.... 

entry. ....... 

entry. . •••••• 

environ - execute a file. • .... 

environ - user environment. 

environment. ... 

environment... 

environment. • • • ... • • 

environment. 

environment... 

environment name. 

environment variabtei.. • • • 

environment variables.. 

eqn.. 

eqn conetructi... 

eqn, neqn, checkeq - typeset mathematics. 

eqnchar ~ epecial character definitione for eqn. 

erase, label, line, circle, arc, move, coat, point, . 

ermo - system error meesagee.. • . • . 

error - analyse and disperse compiler error . 

error log. 

error message file by massaging C source.. 

error messages. . • . 

error messages. .. 

error meesagee. 

error numbers. 

error recoveiy. 

errors. 

escape to kilter robots. .. . • • 

establish terminal characteristics for the. 

etext, edata - lut locations in program. • • • 

Ethernet interface. • . .. 

Ethernet interface. .. 

Euclidean distance.. . 

eval, exec, exit, export, login, newgrp, read,/ eh, « « • • 

eval: re-evaluate shell data. 

evaluate arguments as an expression. • . . 

evaluate shell data.... 

event list.. 

ex. vi . 

ex, edit - text editor. 

examination program. • • . 

exec, exit, export, login, newgrp, read, readonly,/ . . . 

exec: overlay shell with specified command. 

excel, execv, execle, execlp, execvp, environ - . 

execle, execlp, execvp, environ > execute a file. . • • • . 

execlp, execvp, environ - execute a file. 

executable files with pereietent text. 

execute a file. • . . 

execute a file. .. • . . 


crypt(3) 

makek^fi) 

eDd(3) 

SCC8(1) 

ceh{l) 

C8h(l) 

getf8ent(3) 

getgrent(3) 

getho8teat(3N) 

C8h(l) 

getnetent(3N) 

eocket(2) 

getprotoent(3N) 

getpwent(3) 

get8ervcnt(3N) 

cMi) , ^ 

number(3) 

xeendfl) 

alist(3) 

getf8ent(3} 

getgrent(3) 

getho8tent(3N) 

getttetettt(3N) 

getprotoent(3N) 

gctpwent(3) 

getservent(3N) 

syslog(l) 

unlink(2) 

unlink^3P) 

execl(3j 

cnvirott(5) 

ceh(l) 

environ(5) 

printen^l) 

suatools(l) 

t8et(l) 

geten^S) 

Clk(l) 

getenv(3P) 

eqnchar(7) 

deroiI(l) 

eqn(l) 

eqnchar(7) 

plot(3X) 

perror(3) 

ern>r(l) 

dmesg(8) 

mkst^l) 

error(l) 

pern>r(3) 

pciTor(3F) 

intro(2) 

eyacc(l) 

8pell(l) 

cha8e(6) 

tset(l) 

end(3) 

ec(4S) 

en(4S) 

hypot(3M) 

•k(n 

ceh(l) 

expr(l) 

«kfl) 

CBk(l) 

vi(l) 

«x(l) 

•NO 

.fc(l) 

csk(l) 

cxecl(3) 

execl(3) 

execl(3) 

etick^S) 

execl(3) 


execve(2) 
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PtrmuUd Index 


ftUnn - 
system - 
repeat: 
at - 

lastcomm * show last commands 
nox - Unix to nnix command 
acct - 
sleep - suspend 
sleep - suspend 
sleep - suspend 
monitor, monstartup, moncontrol - prepare 

pxp - Pascal 
rexecd - remote 
profil - 

pix - Pascal interpreter and 
file, execi, 

execi, execr, execle, execlp, 
link, symlnk - make a link to an 
tunefs - tune up an 

pending output. 

/if, vkile, break, continue, cd, eval, exec, 

breaksw: 

break: 

logarithm, power, square root. 

glob: filename 
expand, unexpand - 
versa, 
en - Sun 3 Mb/s 

adventure - an 
frexp,' Idexp, modi - split into mantissa and 
exp, log, loglO, pow, sqrt > 
/while,break, continue, cd, eval, exec, exit, 

expr * evaluate arguments as an 
re^comp, re.exec - regular 
addbib - create or 
getfd - get the file descriptor of an 
strings, xstr- 
recovery. 

ioinit > change 
tclese, tread, twrite, trewin, tskipf, tstate - 

functions. 

signal - simplified software signal 
sigvec - software signal 
arithmetic - provide drill in number 
pstat - print system 
true, 

inet - Internet protocol 
without checking the disks, 
the disks, fastboot, 
abort - generate a 
trpfpe, fpecnt - trap and repair floating point 

chmod, 

chown, 


ecvt, 

fopen, freopen, 
ferror, 
inquiries. 

base subroutines, dbminit, 
head ~ display first 
fclose, 

bcopy, bcmp, bsero, 
gctc, 

stream, getc, getchar, 


execute a subroutine after a specified time. . 

execute a UNIX command. • .. 

execute command repeatedly. 

execute commands at a later time. 

executed in reverse order. . 

execution... 

execution accounting file. .. 

execution for an interval. 

execution for an interval. 

execution for interval. 

execution profile. 

execution profiler. .. 

execution server. ... 

execution time profile. 

executor.. • . .. 

execv, execle, execlp, execvp, environ - execute a . . . . 

execve - execute a file. . 

execvp, environ - execute a file. 

existing file. 

existing file system... 

_exit * terminate a process.. . 

exit - terminate a process after flushing any 

exit - terminate process with status. • .. 

exit, export, login, newgrp, read, readonly, set,/ . . , . 

exit from switch. 

exit: leave shell. 

exit while/foreach loop. 

exp, log, loglO, pow, sqii - exponential,. 

expand argument list. 

expand tabs to spaces, and vice versa. 

expand, unexpand - expand tabs to spaces, and vice . • 

experimental Ethernet interface.. . • • 

expire ~ remove outdated news articles. 

exploration game... 

exponent. .. 

exponential, logarithm, power, square root. 

export, login, newgrp, read, readonly, set, shift,/ . • . • 

expr ~ evaluate arguments as an expression. 

expression. .. 

expression handler. 

extend bibliographic database. 

external unit number.... 

extract strings from C programs to implement shared . . 
eyacc ~ modified yacc allowing much improved error . • 

f77 - FORTRAN.?? compiler. . 

f?? I/O initialisation.. . • • 

f?? tape I/O. topen, .. 

fabs, floor, ceil absolute value, floor, ceiling . 

facilities. .. 

facilities. 

facts.. 

facts. .... , 

false - provide truth values. 

false, true - provide truth values. 

family. .. 

fastboot, fasthalt - reboot/halt the system . 

fast halt - reboot/halt the system without checking . • . 

fault. 

faults. , , • « .. 

fbio - general properties of frame buffers. 

fchmod - change mode of file. • .. 

fchown - change owner and group of a file. 

fclose, fflush - dose or flush a stream. 

fcnti •. file control. . *. 

fcnti - file control options... 

fcvt, gcvt - output conveision... 

fdopen - open a stream. 

feof, clearerr, fileno - stream status inquiries. 

ferror, feof, clearerr, fileno - stream status . .. 

fetch, store, delete, firstkey, nextkey - data . 

few lines of specified files. 

fflush - close or flush a stream. 

ffs - bit and byte string operations. 

fg: bring job into foreground. 

fgctc - get a character from a logical unit. 

fgetc, getw - get character or integer from. 


aIarm(3F) 

8y8tem(3F) 

C8h(l) 

at(l) 

lastcomm(l) 

uux(lC) 

acct(5) 

8leep(l) 

8leep(3F) 

8leep(3) 

monitor(3) 

pxp(l) 

rexecd(8C) 

profil(2) 

pix(l) 

exccl(3) 

execvef2) 

execl(3) 

link(3F) 

tunef8(8) 

exitf2) 

exit(3) 

exit(3F) 

.h(i) 

C8h(l) 

C8h(l) 

€8h(l) 

exp(3M) 

C8h(l) 

expand(l) 

expand(l) 

en(4S) 

expires) 

adveiiture(6) 

frcxp{3) 

exp(3M) 

* 1 ( 1 ) 

expr(l) 

expr(l) 

regex(3) 

addbib(l) 

getfd(3F) 

X8tr(l) 

eyacc(l) 

f??(l) 

ioinit(3F) 

topen(3F) 

floor(3M) 

signal(3) 

8igvec(2) 

arithmetic(6) 

p8tat(8) 

true(l) 

fal8e(l) 

inet(4F) 

fast boot(8) 

fastboot(8) 

abort(3) 

trpfpe(3F) 

fbio(4S) 

chmod(2) 

chown(2) 

fcio8e(3S) 

fcntl(2) 

fcntl(5) 

ecvt(3) 

fopen(3S) 

feiTor(3S) 

ferror(3S) 

dbm(3X) 

head(l) 

fclo8e(3S) 

bstring(3) 

csb(l) 

getc(3F) 

getc(3S) 
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PtrmuUi /fiiei 


geii, fgets - get 1 airing from n atream. 

grep, egrep, fgrep > search a file for a pattern. 

access • determine accessibility of file. 

access > detennine accessability of a file... 

acct - execntion accounting file. 

chmod. fchmod - change mode of file.. • • • 

chmod - change mode of a file.... • • 

chowBi fchowB - change owner and group of a file. • .. 

coirm - remove columns from a file. 

core - format of memoiy image file. 

creat-< create a new file.. 

source: read commands from file. .. 

ctags - create a tags file.. .. 

dd - convert and copy a file. 

delta - make a delta (change) to an SCCS file. ... 

execv, execle, execlp, execvp, environ • execute a file, exed... 

execve - execute a file.. 

• apply or remove an advisory lock on an open file, fiock . 

fpr - print Fortran file. .. 

get - get a venion of an SCCS file. • • ... • . • 

group- group file. • *. 

link - make a hard link to a file. • .. 

link, symlnk - make a link to an existing file... 

mkdir - make a directory file. 

mknod - make a special file. 

mknod - build special file. • .. 

more, page - browse through a text file..... 

- rebuild the data base for the mail aliases file, newaliues .. • • . . 

open a file for reading or writing, or create a new file, open - 

puswd - pusword file. 

prs - print an SCCS file. 

remote - remote host description file. • .. 

rename - change the name of a file... 

rename - rename a file.. 

rev - reverse lines of a file.. . • .. 

rmdel - remove a delta from an SCCS file.. 

rmdir - remove a directory file... . . . 

sccsdiff - compare two versions of an sees file. « • « • .. 

scesfile - format of SCCS file. 

sise - siie of an object file. 

printable strings in an object, or other binary, file, strinp - find . 

sum - sum and count blocks in a file. 

symiink - make symbolic link to a file. 

tail - display the last part of a file. 

tmpnam - create a name for a temporary file.. 

touch - update date last modifi^ of a file.. 

unget - undo a previous get of an SCCS file.. • • • 

uniq - report repeated lines in a file. 

uuencode - format of an encoded uuencode file. 

val - validate SCCS file. . .. 

vipw - edit the password file.. . • • . 

vswap - convert a foreign font file.. 

write, writev - write on a file.. 

file - determine file type. 

diff - differential file and directory comparator. 

cpio - copy file archives in and out. 

mkstr - create an error message file by massaging C source. 

diffs - 3-way differential file comparismi... 

fenti - file control. 

fenti - file control options. 

rep - remote file copy.. 

umuk: change or display file creation mask. 

umask - set file creation mode mask.. 

getfd - get the file descriptor of an external unit number. . 

sact - print current SCCS file editing activity. .. 

setfsent, endfsent - get file system descriptor file entry, /getfsspec, getfsfile, getfstype, 

getgigid, getgmam, setgrent, endgrent - get group file entry, getgrent, . 

getpwnam, setpwent, endpwent - get password file entry, getpwent, getpwuid, . 

grep, egrep, fgrep - search a file for a pattern. 

open - open a file for reading or wnting, or create a new file, 
newsre - information file for readnews(l) and checknew8(l). . . . 

aliases - aliases file for sendmail... 

uuencode,uudecode ~ encode/decode a binary file for transmission via mail. 

ar - archive (library) file format. 

tar - tape archive file format. 

which - locate a program file including aliases and paths (esh only). 


gcts(3S) 

grep(l) 

acce88(2) 

acce88(3P) 

acct(5) 

chmod(2) 

chmod(3P) 

chown(2) 

colrm(l) 

core(5) 

creat(2) 

C8h(l) 

ctag8(l) 

dd(l) 

delts^l) 

execl(3) 

execve(2) 

flock(2) 

fpr(l) 

g«t(l) 

gronp(5) 

liiik(2) 

link(3F) 

mkdir(2) 

mknodf2) 

mknod(8) 

more(t) 

Bewaliases(fi) 

open(2) 

pas8wd(5) 

pr8(l) 

remote(6) 

rename(2) 


reBame(3P) 

rev(l) 

rmdeiri) 

rmdir(2) 

8CC8diff(l) 

scc8file(5) 

sue(l) 

string8(l) 

8um(l) 

symliak(2) 

tail(l) 

tmpnam(3C) 

touch(l) 


UBget(l) 

uni<i(l) 

uuencode(5) 

val(l) 

vipw(8^ 

vswap(l) 

writc(2) 

file(l) 

di^l) 

cpio(l) 

mk8tr(l) 

diff3(l) 

fcntl(2) 

fcntl(5) 

rcp(lC) 

C8h(l) 

uma8k(2) 

getfd(3P) 

•»ct(l) 

getf8ent(3) 

getgrent(3) 

getpwent(3) 

grep(l) 

open(2) 

new8rc(5) 

alias 08(5) 

uuencode(lC) 

m 

*«(5) 

which(l) 
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Permuted Index 


fsplit - split » multHrontine Fortnn file into tndmde&l files. 

split - split a file into pieces.. 

pmeige - pascal file merger. « • » .. 

mktemp - make a eniqee file name.. 

fseek, ftell - reposition a file on a logical unit... 

stat, Istat, fstat - get file status. 

mkfs - construct a file system. 

mkproto - construct a prototype file system. 

mount, amount - mount or remove file system. 

mount, amount - mount and dismount file system. . 

newfs - construct a new file system. 

setquota - enable/disable quotas on a file system.. 

tnnefs - tune up an existing file system. 

repair, fsck • file system consistency check and interactive . • 
getfsfile, getfstype, setfsent, endfsent - get file system descriptor file entry, /getfsspec, • . 

dcheck > file system directory consistency check. 

dump - incremental file system dump. .. 

bier - file system hierarchy. • • .. 

dumpfs ' dump file system information. 

quot - Bummarife file system ownership.. * 

restore - incremental file system restore. 

icheck - file system storage consistency check. . • • • • 

mtab - mounted file system table. . 

fs, inode - format of file system volume.. 

df ~ report free disk space on file systems... 

utime - set file times.. .. 

utimes - set file times. 

uusend - send a file to a remote host. 

truncate, ftruncate - truncate a file to a specified length. 

ftp - file transfer program. 

ftpd « DARPA Internet File Transfer Protocol server. 

tftpd - DARPA Trivial File Transfer Protocol server. 

file ~ determine file type. 

editor, vi - view a file without changing it using the vi visual • • » 

basename - strip filename affixes. 

glob: filename expand argument list. 

ferror, feof, clearerr, fileno - stream status inquiries. 

admin - create and administer SCCS files. 

checknr - check nroff/troff files.. 

cmp - compare two files. 

comm • select or reject lines common to two sorted files. 

cenfig - build system configuration files. 

cp - copy files.. 

find-find files.,. 

split a multi-routine Fortran file into individual files, fsptit -. 

head - display fint few lines of specified files. 

install - install files. 

MAKBDBV - make system special files. • • • . .. 

mv - move or rename files.. 

news - USBNBT network news article, utility files... 

rmdir, rm - remove (unlink) directories or files. 

sort - sort or merge files. 

tee - copy standard output to many files.. • 

what - identify the version of files. 

compact, uncompact, ccat - compress and uncompress files, and cat them. 

intro - introduction to special files and hardware support. 

catman - create the eat files for the manual. 

fsync - synchronise a file’s in-core state with that on disk. 

im, rmdir - remove (unlink) files or directories.. 

pr - print file(8), possibly in multiple columns. 

sticky - executable files with persistent text.. . 

fstab - static information about the filesystems. . .. 

coleri - filter nroff output for CRT previewing. • • . . 

col - filter reverse paper motions. 

plot - graphics filters. *.. « . • 

find - find files... 

refer - find and insert literature references in documents. 

find - find files. . 

look - find lines in a sorted list. 

man - print out manual pages; find manual information by keywords. 

ttyname, isatty, ttyslot - find name of a terminal. . .. 

ttynam, isatty - find name of a terminal port. 

lorder ~ find ordering relation for an object library. . • 

binary, file, strings - find printable strings in an object, or other . , 

inverted index to a bibliography .br tookbib - find references in a bibliography, indxbib - make 
spell, spellin, spellout - find spelling errors. . . • .. 


f8plit(l) 

8plit(l) 

pmerge(l) 

mktemp(3) 

f3eek(3F) 

8tat(2) 

mkf8(8) 

mkproto(8) 

mount(2) 

mount(8) 

ttewf8(8) 

8etqaota(2) 

tunef8(8) 

f8ck(8) 

getf8ent(3) 

dcheck(8) 

dump(8) 

hier(7) 

dumpfs(8) 

quot(8) 

restori^S) 

icheck(8) 

mtab(5} 

f»(s) 

df(l) 

utime(3C) 

utime8(2) 

uu8end(lC) 

tnincate(2) 

ftp(lC) 

ftpd(8C) 

tftpd(8C) 

file(l) 

view(l) 

ba8ename(l) 

C8h(l) 

ferror(3S) 

admin(l) 

checknr(l) 

cmp(l) 

commfl) 

config(8) 


f8plit(l) 

head(l) 

in8tall(l) 

makede^S) 

mv(l) 

new8(5) 

rmdi^l) 

8ort(l) 

tee(l) 

what(l) 

compact(l) 

intro(4) 

catman(8) 

f8ync(2) 

rm(l) 

8ticky(8) 

f8tab(5) 

colcrt(l) 

col(l) 

plot(lG) 

find(l) 

refer(l) 

find(l) 

look(l) 

man(l) 

ttyname(3) 

ttynam(3F) 

lorder(l) 

8tring8(l) 

indxbib(l) 

8pell(l) 
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Permutei Indes 


fold - fold long iin<9 for 
head - display 
dbrniatii fetch, store, delete, 
fish - play 

values, flmia, 
extreme values, 
tipfpe, fpecttt - trap and repair 
fptype - check a 
isiaf, tsnaa - test for indetermiaatt 
opea file, 
faactioas. fabs, 
fabi, floor, ceii * abiolate valat, 

fclose, filash - close or 
flash 

exit - termiaate a process after 

device. 

fold- 

vswap - coavert a foreiga 
vfoat- 

break: exit while/ 

fg: briag job iato 
vswap - coavert a 


idate, itime - retara date or time ia aamerical 
dmesg - collect system diagaostic messages to 
ar - archive (library) fils 
damp, dampdates - iacremeatal damp 
tar - tape archive file 
kbd - keyboard traaslatioa table 
iadsat - iadeat aad 
troff - typeset or 
htable - coaveit NIC staadard 
gettable - get NIC 
aaeacode - 
cpio - 
dir- 
fs, iaode - 
core- 
scesfile - 
tbl- 

tp - DEC/mag tape 
vfoat - foat 
scaaf, fscaaf, sscaaf - 
priatf, fpriatf, spriatf - 
fmt - simple text 
areff - text 
m§ - text 
me-macros for 
ratfor - ratioaal 
fpr - priat 
fsplit - split a malti-roatiae 
iatro - iatrodactioa to 
pate, fpatc - write a character to a 

m- 

adage. 

trpfpe, 

priatf, 

aait. pate, 
pate, patchar, 
pats, 

bw - Saa black and white 
fbio - geaeral properties of 

df - report 
allocator, malloc, 
fopen, 
exponent, 
from - who is my mail 


finite width oatpat device.. 

first few llaes of specified files. 

firstkey, aextkey - data base sabioatines. • • 

Fish”.. 

fish-play “Go Fish”. 

flmax, dflmin, dflmax, inmax - retarm extreme 
flmia, flmax, dflmin, dflmax, inmax - retara • 

floating point faalts. 

floating point aamber. . 

floating point valaes.. • • • • 

flock - apply or remove aa advisory lock on an 
floor, cell - absolate valae, floor, ceiling * • * 

floor, ceiling faactioas. • .. 

flash - flash oatpat to a logical aait. 

flash a stream.... 

flash oatpat to a logical aait.. • < 

flashing any pending oatpat. 

fmt - simple text formatter... 

fold - fold long lines for finite width oatpat • . 
fold long lines for finite width oatpat device. • < 

foat file. • .... 

foat formats.... 

fopen, freepea, fdopen - open a stream. . . • < 

foreach loop.... 

foreach: loop over list of names. .. 

fore^oand. 

foreign font file. .. 

fork - create a copy of this process. 

forir - create a new process. 

form.. * • . 

form error log. • • • .. 

format. • • • .. 

format. 

format.. • .. 

format and default table. 

format C program soarce. 

format documents. 

format host tables. 

format host tables from a host. 

format of aa encoded aaeacode file. 

format of cpio archive. 

format of directories. 

format of file system volume. 

format of memory image file. 

format of SCCS file. 

foimat tables for nroff or troff.. 

formats. 

formats. .. 

formatted input conversion. 

formatted output coavenion. 

formatter. 

formatting aad typesetting. • • .. 

formatting macros. 

fomuttiag papers.. 

Fortran dialect... 

Fortran file. 

Fortran file iato individual files. 

FORTRAN library functions. 

FORTRAN logical unit. 

FORTRAN-77 compiler. . 

fortune - print a random, hopefully interesting, 
fpeent - trap aad repair floating point faalts. 

fpr - print Fortran file. 

fprintf, sprintf - formatted output conversion. 
fptype - check a floating point number. • . « . 
fputc - write a character to a FORTRAN logical 
fpatc, putw - pat character or word on a stream. 

fpats - pot a string on a stream. 

frame buffer.. 

frame buffen.. 

fread, fwrite - buffered binary input/out pat. • . 

free disk space on file systems. 

free, realloc, calloc, efree, alloca - memory . • « 

freopen, fdopen - open a stream. 

frexp, Idexp, modf - split into mantissa and • , 
from?. .... 


fold(l) 

head(i) 

dbm(SX) 

fish(6) 

fish(6) 

rangcidF| 

range(SF) 

trpfp^SF) 

frtJT>«(3F) 

isinf(3) 

flock(2) 

floorCSM) 

floor($M) 

fiash(3F) 

fcloBe(SS) 

iash(SF) 

exit(3) 

fmt(l) 

fold(l) 

fold(l) 

vfont(5) 

fopen(3S) 

sail 

cshM 

vswap(l) 

fork(3F) 


foit(2) 

idate(3F) 

dmesg(8) 

ar(6) 

damp(5) 

tai(6) 

kbd(5) 

indent(l) 

tioff(l) 

htable(8) 

gettable(8C) 

aaencode(5) 

cpio(5) 

dirfS) 

f.(6) 

core(3) 

sccsfil^fi) 

tbl(l) 

vfont(S) 

scanf(3S) 

printf(3S) 

fmt(l) 

nroff(l) 

ratfoi(l) 

tMl) 

fsplit(l) 

intro(3F) 

putc(3F) 

f77(l) 

fortune(6) 

tipfpe(3F) 

fpr(l) 

printf(3S) 

fptype(3F) 

putc(3F) 

patc(3S) 

pats(3S) 

bw(4S) 

fbio(4S) 

fread(3S) 

m 

malloc(3) 

fopen(3S) 

frexp(3) 

from(l) 
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Permuted Indent 


scca - front end for the ,SM SCCS subsystem.8cc5(l) 

fs, Inode - format of file system volume.. • f8(5) 

scanf, fscanf, sscanf - formatted Input conversion. •••••« scanf(3S) 

interactive repair, fsck - file system consistency check and.f8ck(8) 

unit, fseek, ftell - reposition a file on a logical .f8eek(3F) 

fseekf ftell, rewind - reposition a stream.f8eek(3S) 

individual files, fsplit - split a multi-routine Fortran file into •••.«• fsplit(l) 

fstab - static information about the filesystems. «... f8tab(5) 

stat, Istat, fstat - get file status.8tat(2) 

that on disk, fsync - synchronise a file's in-core state with.f8ync(2) 

fseek, ftell - reposition a file on a logical unit.f8eek(3F) 

fseek, ftell, rewind ~ reposition a stream.f8eek(3S) 

time, ftime - get date and time.time(3C) 

ftp - file transfer program.ftp(lC) 

server, ftpd - DARFA Internet Fite Transfer Protocol • . • . • ftpd(8C) 

truncate, ftruncate - truncate a file to a specified length. • « • • truncate(2) 

shutdown - shut down part of a full-duplex connection.8hutdown(2) 

gamma - log gamma function.gamma(3M) 

fabs, floor, ceil - absolute value, floor, ceiling functions. • • . ..floor(3M) 

intro - introduction to library functions.. . intro(3) 

intro - introduction to compatibility library functions.....intro(3C) 

intro - introduction to FORTRAN library functions...intro(3F) 

intro introduction to mathematical library functions.. . . . • intro(3M) 

intro - introduction to network library functions. intro(3N) 

jO, jl, jn, yO, yl, - bessd functions.jO(3M) 

cos, tan, asin, acos, atan, atan2 - trigonometric functions, sin,.8in(3M) 

sink, cosh, tank - hyperbolic functions. » • .. • 8inh(3M) 

curses screen functions with ''optimal" cursor motion.. curse8(3X) 

fread, fwrite - buffered binary input/output.fread(3S) 

adventure - an exploration game.adventure(6) 

monop * Monopoly game. ..monop(6) 

snake, snscore - display chase game.nake(6) 

trek - trekkie game. • • • trek(6) 

worm - Play the growing worm game.worm(6) 

Canfield, cfscores - the solitaire card game canfield. ...canfield(6) 

cribbage - the card game cribbage.....cribbage(6) 

hangman Computer version of the game hangman.hangman(6) 

backgammon - the game of backgammon.backgammon(6) 

boggle - play the game of boggle.boggle(6) 

wump - the game of hunt-the-wumpus.. * . wump(6) 

gamma - log gamma function.gamma(3M) 

gamma - log gamma function. .gamma(3M) 

item, madd, msub, mult, mdiv, min, mout, pow, gcd, rpow -> multiple precision integer arithmetic.mp(3X) 

gcore - get core images of running processes.gcore(l) 

ecvt, fcvt, gcvt - output conversion.ecvt(3) 

buffers, kgmon - generate a dump of the operating system's profile . • • kgmon(8) 

abort - generate a fault. .abort(3) 

adbgen - generate adb script...adbgen(8) 

makekey - generate encryption key.makekey(8) 

ncheck - generate names from i-numbeis.nche€k(8) 

rand, srand - random number generator. .rand(3C) 

lex - generator of lexical analysis programs.lcx(l) 

/ittitstate, setstate - better random number generator; routines for changing generators.random(3) 

random number generator, routines for changing generators, /srandom, initstate, setstate - better • . • random(3) 

dkio - generic disk control operations.dkio(4S) 

perror, gerror, termo get system error messages.penor(3F) 

getarg, large - return command tine arguments.getarg{3F) 

getc, fgetc - get a character from a logical unit.getc(3F) 

integer from stream, getc, getchar, fgetc, getw -> get character or .getc(3S) 

from stream, getc, getchar, fgetc, getw - get character or integer ..... getc(3S) 

directory, getewd - get pathname of current working .getcwd(3F) 

getdate - convert time and date from ASCII.getdate(3) 

getdtablesiie - get descriptor table site.getdtable8ise(2) 

getgid, getegid - get group identity.getgid(2) 

getenv - get value of environment variables.getenv(3F) 

getenv - value for environment name.getenv(3) 

getuid, geteuid - get user identity.getuid(2) 

unit number, getfd - get the file descriptor of an external ...... getfd(3F) 

setfsent, endfsent - get file system descriptor/ getfsent, getfsspec, getfsfile, getfstype.getfsent(3) 

file system descriptor file/ getfsent, getfsspec, getfsfile, getfstype. setfsent, endfsent - get.getfsent(3) 

- get file system descriptor file/ getfsent, getfsspec, getfsfile, getfstype, setfsent. endfsent.getf8ent(3) 

descriptor file/ getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent ~ get file system ..getfsent(3) 

getuid, getgid - get user or group ID of the caller. ....... getuid(3F) 

getgid, getegid - get group identity.getgid(2) 

get group file entry, getgrent, getgrgid, getgrnam, setgrent, endgrent ~ ... getgrent(3) 

file entry, getgrent, getgrgid, getgrnam, setgrent, endgrent ~ get group . . . getgrent(3) 

SuD System Release 1.1 - xvii - January 1984 







































































Permutti Indeg 


entry. getKient, 

endhoftent - get networit host entiy. gethostent, 
network hofi entry, getkostent, get host bynddr, 
sethoitent, endhostent • get network host entry. 

host. 

timer. 


get network entry, getnetent, 
entry, getnetent, getnetbynddr, 
endnetent - get network entry. 

nrgT, 


getpid, 
schedniing priority, 
protocol entry, getprotoent, getprotobynvmber, 
endprotoent - get protocol entry, getprotoent, 
setprotoeni, endprotoent - get protocol entry. 

get pnssword file ent^. 
entry, getpwent, getpwnid, 
pnssword file entry, getpwent, 
resonrce consumption. 

ntilisntion. 

service entry, getservent, getsenrbyport, 
endsenrent - get service entry, getiervent, 
setservent, endservent • get service entry. 

sockets. 

time. 


cnller. 

getc, getchnr, fgetc, 
vndvise - 

shutdown > close down the system nt n 

nnd time to ASCII, ctime, locnltime, 
fish - piny “ 
setjmp, longjmp - non-locnl 


grnph - drnw n 

gprof - dispiny cnil 
perfmon - 

gxtest - stnnd nione test for the Son video 
colordemos - demonstmte Son Color 
drnw - itttemctive 
plot - 
eg - Son color 

nrc, move, cont, point, linemod, spnce, closepi - 

plot - 

vgrind - 
chgrp - chnnge 
getpgrp - get process 
killpg - send signni to n process 
setpgrp - set process 

getgroops - get 
initgioops - initialise 
setgroops - set 
group - 

getgrgid, getgmnm, setgrent, endgrent > get 


getgmnm, setgrent, endgrent - get group file. 

getgroups - get group access list. 

gethostbynddr, gethostbynnme, sethostent, . 

gethostbynnme, sethostent, endhostent - get. 

gethostent, gethostbynddr, gethostbynnme, . 

gethostid - get unique identifier of current host. 

gethostnnme, sethostnnme ~ get/set nnme of current . • 

getitimer, setitimer - get/set vnlue of interval . 

getlog - get user’s login nnme. 

getlogitt - get login nnme.. . 

geinetbynddr, getnetbynnme, setnetent, endnetent - « * 

getnetbynnme, setnetent, endnetent get network • « « 
getnetent, getnetbynddr, getnetbynnme. setnetent, • • . 

getopt, optnrg, optind - get option letter from. 

getpngesiie ~ get system page site. 

getpnss - read n pnssword. .. • 

getpeemnme - get nnme of connected peer. •••*•« 

getpgrp > get process group. 

getpid - get process id... 

getpid, getppid - get process identification. 

getppid * get process identification. 

getpriority, setpriority - get/set program . 

getpiotobynnme, setprotoent, endprotoent - get * • • • 
getpiotobynumber, getpiotobynnme, setprotoent, • • • 
getprotoent, getprotobynumber, getprotobynnme, • « • 

getpw - get nnme from oid... 

getpwent, getpwoid, getpwnnm, setpweni, endpwent - 
getpwnnm, setpwent, endpwent • get pnssword file • • • 
getpwoid, getpwnnm, setpwent, endpwent - get * • • • 
getrlimit, setriimit - control miximom sjrstem • • • . • 

getrosnge - get information about resource . 

gets, fgets - get n string from n stream. . 

getservbynnme, setservent, endservent - get 

getservbypoit, getservbynnme, setservent. 

getservent, getservbyport, getservbynnme, • .. 

getsocknnme - get socket nnme.. * • 

getsockopt, setsockopt - get and set options on • • • • 
gettnble - get NIC format host tables from a host • • • 

gettimeofdny, settimeofdny - get/set date nnd . 

getty - set terminal mode. 

gettytnb - terminal configuration data base. ••«••• 

getoid, geteuid - get user identity. 

getuid, getgid - get user or group ID of the . 

getw - get character or integer from stream. .. 

getwd - get current working directory pathname. • • • 

give advice to paging ssrstem. 

given time. • • *.. • « « • 

glob: filename expand argument list. *. 

gmtime, asctime, timeione, dysise - convert dale • • • 

QqFish”... 

goth... 

goto: command transfer. 

gprof * display call graph profile data. . 

graph. . , • . ... . 

graph - draw a graph.. • 

graph profile data. . 

graphial display of general system statistics. • • • • • 

graphics board... 

Graphics Display. • • • .. 

graphics drawing. • • ... • . » • 

graphics filters.. . . 

graphics interface. .. 

graphics interface, /erase, label, line, circle, . 

graphics interface. .. 

grep, e^ep, fgrep - search a file for a pattern. • • • • • 

grind nice listings of programs. 

group... 

group.. • • 

group.... • 

group. • • • .. 

group • group file. .. • • « 

group access list. • « ..* . * 

group access list. • . . • .. 

group access list. * .... 

group file. ... 

group file entry, getgrent. 


geigrent(8) 

getgroupB(2) 

gethostent(3N) 

gethostent(3N) 

gethostent(3N) 

gethostid(2) 

getho8tname(2) 

getitimei(2) 

getlog(3P) 

gctlogin(3) 

getnetent(3N) 

getnetent(3N) 

getnetent(3N) 

getopt(3C) 

getpage8iie(2) 

fetpu8(3) 

getpeemame(2) 

geipidfSP) 

geipid(2) 

getpid(2) 

getpriority(2) 

getprotoentrSN) 

getprotoent(3N) 

getprotoent(3N) 

fetpw(3) 

getpwentfS) 

getpwent(3) 

getpwent(3) 

getiiimit(2) 

getru8ag^2) 

get8(3S) 

getservent(3N) 

getservent(SNi 

get8ervent(3N) 

getsockname(2) 

getsockopt(2) 

gettable(8C) 

gettimeofday(2) 

g«tty(8) 

gett^ab(5) 

getuid(2) 

getuid(3P) 

getc(3S) 

getwd(3) 

vadvi8^2) 

shutdownfg) 

ctiine(3) 

iih(6) 

•etjmp(3) 

C8h(l) 

fpn((l) 

fr»pk(ia) 

cnpMlG) 

sprel(l) 

peifmon(l) 

gxte8t(8s) 

coloidemo8(6) 

draw(6) 

plot(lG) 

e«(4S) 

plotfSX) 

plot(5) 

vgrind(l) 

chgnKl) 

g«tpgrp(2) 

killpg(2) 

setpgrp(2) 

group(S) 

getgroup8(2) 

initgroup8(3) 

8etgroup8(2) 

group(5) 

getgrent(3) 
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Permuted Index 


setresid * set real aEd effective 
setmidi setgid, setegid, setigid - set user and 
getuij/get^d - get user or 
getgid, getegid - get 
groups - show 
chown, fchowfi - change owner and 
make • maintain program 

worm - Play the 
stty. 

graphics board. 

stop: 

reboot - reboot system or 
fastboot) fasthalt - reboot/ 
rmail - 

re_comp, rejexec - regular expression 
hangman - Computer version of the game 

vhangup - virtually 
ttohup: run command immune to 
crash - what 
link - make a 
intro - introduction to special files and 
uptime - show how long system 
checknews - check if user 
rehash: recompute command 
unhash: discard command 
hashstat: print command 

leave ~ remind you when you 
help - ask for 

od - octal, decimal, 

hier - file system 
histoiy; print 

fortune - print a random, 
gethostid - get unique identifier of current 
gethostname, sethostname - get/set name of current 
hostnm - get name of current 
rdato - set system date from a remote 
uusend - send a file to a remote 
gettable - get NIC format host tables from a 
htons, ntohS, ntohs - convert values between 
remote - remote 
sethostent, endhostent - get network 
hosts ” 
phones - remote 
ruptime - show 
hostid - print identifier of current 
hostname - set or print name of current 
htable - convert NIC standard format 
gettable - get NIC format 

system. 


uptime - show 

between host and network byte order, 
and network byte order, htonl, 
wump - the game of 
sinh, cosh, tanh - 

ff«ta!g, 


getpid - get process 
setregid - set real and effective group 
setgid, setegid, setrgid - set user and group 
getuid, getgid - get user or group 
su «substitute user 
form. 

getpid, getppid get process 


group ID... 

group ID. setuid, seteuid. 

group ID of the caller. • *. 

group identity. 

group memberships.. . • • 

group of a file. 

groups. ..*. * *. 

groups - show group memberships. 

growing worm game. *. 

gtty - set and get terminal state. • .. 

gxtest - stand alone test for the Sun video . • . 

halt - stop the processor. .* • • 

halt a job or process.. « 

halt processor. 

halt the system without checking the disks. • • . 

handle remote mail received via uucp. 

handler. 

hangman. . 

hangman - Computer version of the game hangman. 

hangup” the current control terminal. 

hangups. .. 

happens when the system crashes. ....... 

hard link to a file.. . 

hardware support. . ... • • • « 

has been up... 

has news on the USENET news network. 

hash table.. 

hash table. 

hashing statistics. 

hashstat: print command hashing statistics. . . . 

have to leave.. • • 

help..... 

help ask for help... 

hex, ascii dump. 

hier - file system hierarchy. 

hierarchy.*. 

history event list.. 

histoiy: print histoiy event list. 

hopefully interesting, adage. 

host.... . « . . 

host. .. 

host.... . 

host. 

host. .... 

host.... 

host and network byte order, htonl, . 

host description file. 

host entry, /gethostbyaddr, gethostbyname, . « 

host name data base. 

host phone number data base. 

host status of local machines. 

host system. 

host system. .. 

host tables. 

host tables from a host. • .. 

hostid - print identifier of current host system, 
hostname - set or print name of current host • • 

hostnm - get name of current host. 

hosts - host name data base. 

how long system has been up. .. 

htable - convert NIC standard format host tables, 
htonl, htons, ntphl, ntohs ~ convert values • • . , 
htons, ntohl, ntohs - convert values between host 

hunt-the-wumpus. 

hyperbolic functions. 

hypot, cabs - Euclidean distance. 

aaigc ~ return command line arguments. 

icheck - file system storage consistency check. . . 

icmp - Internet Control Message Protocol. 

id.. 

ID.. 

ID. setuid, seteuid, setruid, .. 

ID of the caller. .. 

id temporarily..... 

idate, itime - return date or time in numerical , . 
identification. 


8etregid(2) 

Betuid(3) 

getuid(3F) 

getgid(2) 

group8(l) 

chown(2) 

make(l) 

group8(l) 

worm(6) 

8tty(3C) 

gxte8t(88) 

halt(8) 

€8h(l) 

reboot(2) 

fa8tboot(8) 

rmail(8) 

regex(3) 

hangmaD(6) 

hangman(6) 

vhangup(2) 

C8h(l) 

crash(88) 

link(2) 

intro(4) 

nptime(l) 

checknew8(l) 

€8h(l) 

C8h(l) 

csh(l) 

csh(l) 

leave(l) 

help(l) 

help(l) 

od(l) 

hier(7) 

hier(7) 



foitune(6) 

getho8tid(2) 

getho8tname(2) 

ho8tnm(3F) 

r<late(8) 

uu8end(lC) 

gettable{8C) 

byteordcr(3N) 

remote(6) 

getho5tent(3N) 

h08t8(5) 

phones(5) 

ruptime(lC) 

ho8tid(l) 

hostname(l) 

htable(8) 

gcttable(8C) 

hostid(l) 

ho8tname(l) 

ho8tnm(3F) 

ho8ts(5) 

uptime(l) 

htable(8) 

byteorder(3N) 

byteorder(3N) 

wump(6) 

8inh(3M) 

hypot(3M) 

getarg(3F) 

icheck(8) 

icmp(4P) 

getpid(3F) 

8ctregid(2) 

8€tuid(3) 

getuid(3F) 

8U(1) 

idate(3F) 

getpid(2) 
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Ptrmutti Index 


gethofftid - unique 
bostid - prinl 
whjki - 

l^etsid, i^eiegid - get groap 
getnid, getenid - get nser 
setienid - set xeaJ and effective user 
perror, gerror, 


checknews - check 
exit, export, login, newgrp, read,/ sb, for, case, 

interface, vp - 
abort ~ terminate abruptly with memory 
com - format of memory 
gcom - get core 

notify: request 
nobup: run command 
xitr - extract strings from O programs to 
^acc modified yacc allowing much 
ar - Archive 1/4 
tm - tapemuter 1/2 
which - locate a program file 
dump, dumpdates - 
dump - 
restore - 

indent - 

tgetflag, tgetstr, tgoto, tputs - terminal 
tsini, isnan - test for 
ptx - permuted 

stmeat, stremp, stmemp, strepy, stmepy, strlen, 

objects. 

rrferences in a/ indxbib - make inverted 

last- 
syscali - 

fsplit > split a multi-routine Fortran file into 
.br lookbib - find references in a bibliography. 

servers - 

inet.netof, ineOtoa - Internet address/ 

address/ inet.addr, inet^networfe, inetjmakeaddr, 
Internet addmss/ inet^addr, inet.network, 
inetjiddr, inet.network, inetjmakeaddr, inetjnaof, 
inetjsetof, inetjPtoa - Internet/ inet.addr, 
/inetjPoakeaddr, inetjnaof, ittet.netof, 

dumpfs - dump file system 
pac - printer/plotter accounting 
getrusage - get 
vtimes - get 
fstab - static 

man - print out manual pages; find manual 

newsrc - 

miscellaneous - miscellaneous useful 


init - process control 
ioinit - change f77 I/O 
ttys - terminal 
initgroups • 
connect - 
popen, pciose - 

generator, routines for changing/ random, srandom, 
flmin, flmax, dflmin, dflmax, 
clri - clear 

read, readv - read 
soelim - eliminate .so's from nroff 
scanf, fscanf, sscanf - formatted 
ungetc - push character back into 
fread, fwrite - buffered binary 
stdio - standard buffered 
ferror, feof, clearerr, fileno - stream status 


identifier of current host. 

identifier of current host Bjsiem .. • « • 

identify the version of files. 

identity. 

identity. .. 

ID’S. 

ieimo - get system error messages. 

if - general properties of network interfaces. . • • 

if: conditional statement. • . • .. 

if user has news on the USENET news network, 
if, while, break, continue, cd, eval, exec, • • * 
ifeonfig - configure network interface parameten. 
Ikon 10071-5 Multibus Versatec parallel printer 

image. . 

image file... 

images of running processes. 

imemtest - stand alone memory test. .. 

immediate notification.. 

immune to hangups. 

implement shared strings. 

improved error recovery... 

inch Streaming Tape Drive.. . 

inch tape drive. 

including aliases and paths (esh only).. 

incremental dump format.. 

incremental file system dump. 

incremental file system restore. « • • .. 

indent - indent and format C program source. • • 

indent and format C program source. 

independent operation routines, tgetent, tgetnum, 

indeterminate floating point values. 

index.. • . 

index, rindex - string operations, streat, • . • • 
index, rindex, Inbink, len - tell about character 
index to a bibliography .br lookbib - find . • • . 

indicate last logins of usen and teletypes. • • * • 

indirect system call. 

individual files... 

indxbib - make inverted index to a bibliography * 

inet - Internet protocol family. .. 

inet server data base. .. 

inet.addr, inet^network, inetjoiakeaddr, inetjnaof, 
inetd - internet services daemon. 
inetjnaof, inet.netof, inei_.tttoa - Internet • . , 
inet.makeaddr, inetjnaof, inet^netof, inci.ntoa - 
inet.netof, inetjntoa - Internet address/ . • • • 

inet .network, inetjmakeaddr, inet.Inaof, . • . • 

inetjntoa - Internet address manipulation. • • • 

inews - submit news articles. 

information. 

information. 

information about resource utilisation. 

information about resource utilisation. 

information about the filesystems. 

information by keywords. 

information file for readnew8(l) and checknew8(l). 

information pages. 

init - process control initialisation. .. 

initgroups - initialise group access list. . 

initialisation. 

initialisation. 

initialisation data. . ... 

initialise group access list. .. 

initiate a connection on a socket. 

initiate I/O to/from a process.. 

initstate, setstate - better random number • • » 

inmax - return extreme values. 

i-node.. .. 

inode - format of file system volume.* 

input... 

input... 

input conversion. .. 

input stream.. 

input/output. .. 

input/output package. 

inquiries. .. 


getho8tid(2) 

ho8tid(l) 

what(l) 

gctgid(2) 

getuid(2) 

8etreuid(2) 

peiTor(SF) 

if(4N) 

C8h(l) 

checknew8(l) 

sh(l) 

ifconfig(8C) 

vp(4S) 

aboTt(3F) 

core(5) 

gcore(l) 

imemte8t(88) 

cshfl) 


C8h(l) 

X8tr(l) 

eyacc(l) 

ar(4S) 

tm(4S) 

which(l) 

dumpfsi 

dump(8) 

re8tore(8) 

indentfl) 

indent(l) 


• • « teimcap(3X) 

• • * i8inf(3) 

. . . ptx(l) 

• • . 8tring(3) 

• « • index(3F) 

• • * indxbib(l) 

. • • Ia8t(l) 

• • • sy8call(2) 

• , • f8plit(l) 

• . « indxbi^l) 

• * . inet(4F) 

• • • 8etver8(5) 

• . inet(aN) 

• • « inetd(8C) 

• . • inetf3N) 

• • • inet(3N) 

. • • inet(3N) 

• • * inet(3N) 

• • • iaet(3N) 

. • . iaew8(l) 

. . • dumpfs(8) 

. . . p»e(8) 

. . • fetra8age(2) 

• • • vtime8(3C) 

. • • f8tab(5) 

• • • man(l) 

• . » new8r^5) 

. ♦ • intro(7) 

• . • init(8) 

• . • initgroup8(S) 

• . • init(8) 

. • • ioinit(3F) 

. • . ttys(6) 

• . • tttitgroups(3) 

• • . connect(2) 

• . • popen(3S) 

• . • random(3) 

• • . range(3F) 

• . • clri(8) 

• . . f8(5) 

• « • read(2) 

• . • 8oelim(l) 

• • • 8canf(3S) 

• . . ungetc(3S) 

• • • fread(3S) 

• • • intro(3S) 

. . • ferro^SS) 
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Permuted Index 


rrfcr - find and insert literature references in documents. . . . 

insque, remque - insert/remove element from a queue. 

queue, insque, remque - insert/remove element from a 

install - install files. 

install - install files. 

drair - interactive sraphics drawing. 

fsck ~ file system consistency check and interactive repair. 

fortune - print a random, hopefully interesting, adage. 

eg ~ Sun color graphics interface.. . • . 

ec - 3Com 10 Mb/s Ethernet interface. 

en - Sun 3 Mb/s experimental Ethernet interface.. • • 

lo ~ software loopback network interface. 

mti Systech MTI-800/1600 multUerminal interface.. 

mtio - UNIX magnetic tape interface. 

cent, point, linemod, space, closepl - graphics interface, /erase, label, line, circle, arc, move, 

plot > graphics interface. 

tty - general terminal interface. 

- Ikon 10071-5 Multibus Versatec parallel printer interface, vp .. 

Versatec printer/plotter and Centronics printer interface, vpc - Systech VPC-2200 •••«*. 

ifeonfig -* configure network interface parameters... 

telnet - user interface to the TELNET protocol. 

if - general properties of network interfaces. • • • .. 

swapon - add a swap device for interleaved paging/swapping. . 

sendmail - send mail over the internet... 

inet^makeaddr, iaetjnaof, inet^netof, inet^ntoa - Internet address manipulation, /inet^network, 

iemp - Internet Control Message Protocol. 

ftpd - DARPA Internet Pile Transfer Protocol seiver. .... 

ip - Internet Protocol. 

inet - Internet protocol family. .. 

inetd - internet services daemon. 

tep - Internet Transmission Control Protocol. 

udp " Internet User Datagram Protocol. 

ip « Disk driver for Interphase 2180 SMD Disk Controller. 

spline * interpolate smooth curve. 

pti - phototypesetter interpreter. ... 

px - Pascal interpreter. .. 

pix - Pascal interpreter and executor.. 

pi - Pascal interpreter code translator. 

esh - a shell (command interpreter) with C-like syntax.. 

pipe - create an interprocess communication channel. 

* atomically release blocked signals and wait for interrupt, sigpause • . • .. 

onintr process intermpts in command scripts. 

sleep - suspend execution for an interval... 

sleep - suspend execution for interval. 

sleep - suspend execution for an interval... 

intro - introduction to commands. . .. 

intro - introduction to compatibility library functions. . 
intro - introduction to FORTRAN library functions. 

intro - introduction to library functions. 

intro - introduction to mathematical library functions, 
intro - introduction to network library functions. . . • 

intro - introduction to other libraries. 

intro - introduction to spedal files and hardware support, 
intro - introduction to system calls and error numbers, 
commands, intro - introduction to system maintenance and operation 

ncheck - generate names from i-nnmbers. 

find references in a bibliography, indxbib - make inverted index to a bibliography .br lookbib - 

tread, twrite, trewin, tskipf, tstate - f77 tape I/O. topen, tclose, .. 

ioinit - change f77 I/O initialization. 

select - synchronous I/O multiplexing.. 

mem, kmem, mbmem, mbio - main memory and I/O space. 

iostat - report I/O statistics. . 

popen, pclose - initiate I/O to/from a process. 

iocti - control device. 

ioinit ~ change f77 I/O initialization.. 

iostat - report I/O statistics. 

Controller, ip - Disk driver for Interphase 2180 SMD Disk . 

ip - Internet Protocol. 

sail ~ multi-user wooden ships and iron men. .. 

whatis - describe what a command is. 

isalpha, is upper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, is print, isentri,/ • . . 

isalnum, isspace, ispunct, isprint, iscntrl,/ isalpha, isnpper, islower, isdigit, isxdigit, . . . 

/isalnum, isspace, ispunct, isprint, iscntrf, isascii, isgraph, toupper, tolower, toascii -/ . . 

ttynam, isatty - find name of a terminal port. 

ttyname, isatty, ttyslot - find name of a terminal. . . . 

|l^isxdigit, isalnum, isspace, ispunct, isprint, iscntrl, isascii, isgraph, toupper, tolower,/ . • . 


refcr(l) 

in8que(3) 

iQ8que(3) 

in8tall(i) 

in8tall(l) 

draw(6) 

f8Ck(8) 

fortane(6) 

cg(4S) 

ec(4S) 

en(4S) 

lo(4) 

mti(4S) 

mtio(4) 

plot(3X) 

plot(5) 

tty(4) 

vp(4S) 

vpc(4S) 

ifconfig(8C) 

telnet(lC) 

if(4N) 

8wapon(2) 

sendmail(8) 

inet(3N) 

icmp(4P) 

ftpd(8C) 

ip{4P) 

ii>.t(4F) 

inetd(8C) 

tcp(4P) 

ud|^4P) 

ip(4S) 

8pline(lG) 

pti(l) 

pix(l) 

Pi(l) 

C8h(l) 

pipc(2) 

sigpau8e(2) 

C8h(l^ 

sleepfl) 

sleepfO) 

8lcep(3F) 

intro(l) 

introfSO) 

intro{3F) 

intro(3) 

intro(3M) 

intro(3N) 

intro(3X) 

intro(4) 

intro(2) 

intro(8) 

ncheck(8) 

indxbib(l) 

topen(3F) 

ioinit(3F) 

8clect(2) 

mem(4S) 

lost at (8) 

popen(3S) 

ioctl(2) 

ioinit(3F) 

iostat(8) 

ip(4S) 

ip(4P) 

sail(6) 

whatis(l) 

ctype(3) 

ctype(3) 

ctype(3) 

ttynam(3F) 

ttyname(3) 

ctype(3) 
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Permuted Index 


isprini, iscntrl,/ isilpha, i8iipp«r, islowcr, 
/isspftce, ispnnct, isprint, iscntrl, isascii, 
point vaJoes. 

tspuAct, isprint, Iscntxi,/ isalpha, isnp^r, 
values, isinf, 

/isdigit, iaxdigit, isalnum, isspace, ispunct, 
/islower, isdisit, isxdigit/ isalnum, isspace, 
/isupper, islower, isdi^it, isxdigit, isalnum, 

system - 

isspace, ispunct, isprint, iscntii,/ isalpha, 
iacntrl,/ isalpha, isupper, islower, isdigit, 
vi - view a file without changing 
idate, 

rpow - multiple precision integer arithmetic, 
suspend: suspend a shell, resuming 

jo. 
jO, jl. 

bg: place 
fg: bring 
jobs: print current 
stop: halt a 

crontab - table of times to run periodic 

kill: kill 
Iprm - remove 


default table, 
makekey - generate encryption 
table, kbd- 

print out manual pages; find manual information by 

profile buffers. 

process. 

kill: 

chue - Txy to escape to 

mem, 
quis - test your 

linemod, space, closepi - graphics/ openpl, erase, 
awk - pattern scanning and processing 
be - arbitrary-precision arithmetic 
set, shift, times, trap, umask, wait - command 

epp - the C 
order. 

frexp, 

leave - remind you when you have to 

exit: 

index, rindex, Inblnk, 
ftruncate - truncate a file to a specified 
getopt, optaig, optind - get option 

lex - generator of 
intro - introduction to other 
ranlib - convert archives to random 
lorder * find ordering relation for an object 
ar - archive ( 
intro - introduction to 
intro - introduction to compatibility 
intro - introduction to FORTRAN 
intro - introduction to mathematical 
intro - introduction to network 
ar - archive and 
esh - a shell (command interpreter) with C- 

limit: adter per-process resource 
unlimit: remove resource 
utimit - get and set user 
getarg, iarge - return command 
space, closepi - graphics/ openpl, erase, label, 

bk- 
Ipr - off 


isdigit, isxdigit, isalnum, isspace, ispunct. 

isgraph, toupper, tolower, toascii - character/ . 

isinf, isnan - test for indeterminate fioating . 

islower, isdigit, isxdigit, isalnum, isspace. 

isnan - test for indeterminate floating point .. 

isprint, isentri, isascii, isgraph, toupper,/ . 

ispunct, isprint, isentri, isascii, isgraph,/ . 

isspace, ispunct, isprint, isentri, isascii,/. 

issue a shell command. . 

isupper, islower, isdigit, isxdigit, isalnum, .. 

isxdigit, isalnum, isspace, ispunct, isprint,.. « 

it using the vi visual editor. 

itime - return date or time in numerical form. 

itom, madd, miub, mult, mdtv, min, mout, pow, ged, • • 

iU superior. ... • 

jO, jl, jn, yO, yl, 3 m - bessel functions. 

jl, jn, yO, yl, yn - bessel functions. 

jn, 3 r 0 , yl, 3 m - bessel functions. 

job in background. 

job into foreground. .. 

job list... 

job or process. . 

jobs.. « • « • 

jobs and processes. . • .. 

jobs from the line printer spooling queue. 

jobs: print current job list. 

join - relational database operator. .. 

kbd - keyboard translation table format and . 

key. 

keyboard translation table format and default . 

keywords, man - . 

kgmon - generate a dump of the operating system's • • 

kill - send a signal to a process. . 

kill - send a signal to a process, or terminate a. 

kill - send signal to a process. • • . ... • • 

kill jobs and processes. • • • • ..* • 

kill: kill jobs and processes. 

killer robots. • .. 

killpg ~ send signal to a process group. 

kmem, mbmem, mbio - main memory and I/O space. . . 
knowledge. 

label, line, circle, arc, move, cont, point,. 

language.. • • « 

language.. * . 

language, /export, login, newgrp, read, readonly, • * • 

language preprocessor. 

lastcomm - show last commands executed in reverse • • 

Id - link editor. . 

Idexp, modf split into mantissa and exponent. 

leave. 

leave - remind you when you have to leave. 

leave shell. 

len - tell about character objects. 

length, truncate,. 

letter from argv. . 

lex ~ generator of lexical anal 3 rsis programs. «*•... 

lexical anal 3 r 8 is programs. • ... • • • 

libraries.. 

libraries. 

library. 

library) file format. 

library functions. .... 

library functions. 

library functions.. 

library functions.. • • • • 

library functions. 

library maintainer. • « • . .. 

like syntax... 

limit: alter per-process resource limitations. 

limitations. 

limitiations. • • .. 

limits.. *.*. 

line arguments. 

line, circle, arc, move, cont, point, linemod, . 

line discipline for machine-machine communication. • . • 
line print. • • .. 


ctypeTS) 

ctyi>«(3) 

i8iiif(3) 

etype(3) 

i«i&f(3) 

ctype(3) 

etypefS) 

ctype(3) 

sy8tem(3) 

ctype(3) 

ctype(3) 

view(l) 

idate(3F) 

mp(3X) 

C8h(l) 

iO{3M) 

iO(3M) 

jO(3M) 

cshfl) 

cshil) 

cshfl) 

csh(l) 

crontab(6) 

C8h(l) 

Iprmfl) 

csh(l) 

join(l) 

kbd(5) 

makekQr(8) 

kbd(5) 

man(l) 

kgmon(8) 

kill(3F) 

kill(l) 

kill(2) 

cshfl) 

csh(l) 

chaseffi) 

kiHpg(2) 

mem(dS) 

quis(6) 

plot(3X) 

*wk(l) 

Ml) 

.h(l) 

epp(l) 

lastcommfl) 

ld(l) 

frexp(3) 

leave(l) 

leave(l) 

cshfl) 

index(3F) 

truncate(2) 

getopt(3C) 

aii 

intro(3X) 

ranlibfl) 

lorderfl) 


ai(5) 

intro(3) 

iatro(3C) 

introfSF) 

intro(3M) 

intro(3N) 

Ml) 

C8^l) 

cshfl) 

cshfl) 

cshfl) 

ulimit(3C) 

getargfSF) 

plot(3X) 
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Permuted Index 


Ipc- 

Ipd- 

tprm - remove jobs from the 
/eme, label, line, circle, arc, move, coat, point, 
comm - select or reject 
fold - fold Ions 
nniq - report repeated 
lock - find 
rev - revene 
head - display first few 
readtink - read value of a 83 rmbolic 


Id- 

a.ont - assembler and 

link - make a hard 
symliak - make sym^lic 
link, symlnk ~ make a 
In - make 

glob: filename expand argument 
history: print history event 
jobs; print current job 
shift; manipulate argument 
Setgroups - get group access 
initgroups - initialise group access 
look " find lines in a sorted 
niist - get entries from name 
nm - print name 
setgroups - set group access 
varargs - variable argument 
Is - 

foreach: loop over 
use» - compact 

listen - 
vgrind - grind nice 
refer - find and insert 

index, rindex. 


convert date and time to ASCII, ctime, 
(csb only)< which - 
whereii - 
end, etext, edata - last 
fleck - apply or remove an advisory 
‘Mogin»», 

» collect system diagnostic messages to form error 
syslog, openlog, ctoselog - control system 
syslog - make system 
gamma - 
power, square root, exp, 
syslog - 
square root, exp, log, 
exp, log, leg 10, pow, sqrt - exponential, 
rwho - who^s 
flush ^ flush output to a 
fseek, ftell - reposition a file on a 
getc, fgeCe - get a character from a 
pute, fpute ” write a character to a FORTRAN 
lockscreen - maintain window context until ** 
riogin - remote 


ac - 


getlog - get user’s 
getlogin -> get 
login: 

/., break, continue, cd, eval, exec, exit, export, 
passwd - change 
utmp, wtmp - 
riogind ~ remote 
chsh ~ change default 
last ~ indicate last 
bsuncube - view 3-D Sun 


line printer control program. 

line printer daemon... 

line printer spooling queue. .. 

linemod, space, closepi - graphics interface. 

lines common to two sorted files. 

lines for finite width output device.. 

lin^ in a file.. 

lines in a sorted list. 

lines of a file.... • 

lines of specified files. . .. 

link.. . 

link - make a hard link to a file. 

link editor. 

link editor output. 

link, symlnk - make a link to an existing file. 

link to a file.. 

link to a file... 

link to an existing file... 

links. 

lint - a C program verifier. . .. 

list. 

list.. .... 

list. 

list. 

list.. 

list. « • . • ... 

list...... . . 

list.. • . • .. 

list.. 

list..... 

list. . • .. 

list contents of directory... 

list of names. ... 

list of users who are on the system. • • • .. 

listen - listen for connections on a socket. 

listen for connections on a socket.. 

listings of programs.. • • *. 

literature references in documents. « . .. 

In - make links. 

Inblnk, len - tell about character objects. 

lo - software loopback network interface. .. 

loc - return the address of an object. .. 

localtime, gmtime, asctime, timesone, dysise - . . . . . 
locate a program file including aliases and paths • « « . 
locate source, binary, and/or manual for program. • • . 

locations in program. 

lock on an open file.. 

lockscreen - maintain window context until .. 

log. dmesg . 

lofi.. 

log entry. 

log gamma function. . 

log, loglO, pow, sqrt - exponential, logarithm, . 

tog systems messages. 

toglO, pow, sqrt - exponential, logarithm, power, • . • . 

logarithm, power, square root. 

logged in on local machines.. « • . . 

logical unit. • • ... 

logical unit...... * 

logical unit. 

logical unit. .. 

login”... 

login. 

login - sign on. 

login accounting. 

login: login new user. . 

login name. 

login name. 

login new user.. 

login, ncwgrp, read, readonly, set, shift, times,/ .... 

login password.. .. 

login records. 

login server. . 

login shell. .. 

logins of users and teletypes. . .. 

logo. 


Ipc<8) 

lpd(8) 

Iprm(l) 

plot(3X) 

comm(l) 

foia(l) 

look(l) 

rev(l) 

head(l) 

readlink(2) 

link(2} 

ld(l) 

a.out(5) 

link(3F) 

link(2) 

8ym!ink(2) 

tiuk(3F) 

ln(l) 

cshfli 

cshjli 

cshfli 

csh(l} 

getgroups(2) 

initgroup8(3) 

look(l) 

nli8t(3) 

nm(l) 

8etgroup8(2) 

varargs(3) 

ls(l) 

C8h(l) 

U8ers(l) 

li8ten(2) 

li8ten(2) 

vgrind(l) 

rcfcr(l) 

ln(l) 

index(3F) 

lo(4) 

loc(8F) 

ctime(3) 

which(l) 

whereiB(l) 

end(3) 

flock(2) 

lock8creen(l) 

dme8g(8) 

syslo^aj 

syslogtl) 

gamma(3M) 

exp(3M) 

8y8log(8) 

exp(dM) 

exp(3M) 

rwho(lC) 

flu8h(3F) 

f8eek(3F) 

gctc(3F) 

putc(3F) 

lock8creen(l) 

rtogi&(lC) 

login(l) 

»c(8) 

C8h(l) 

getlog(3F) 

getlogin(d) 

C8h(l) 

. 1 ( 1 ) 

pa88wd(l) 

utmp(6) 

rIogind(8C) 

chsh(l) 

last(l) 

bsuncube(6) 
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PtrmuUd Indes 


aetjmp, 

/- make inverted index to a bibliography .br 
break: exit while/foreach 
continue: cycle in 
end: terminate 
foreack: 
lo - software 
library. 


queue. 


•tat, 

•nn - » cnrrent 
vax - ii cnmnt 
bk - line discipline for machine- 
bk - line discipline for 
ruptime - show host staUs of local 
rwho - who*i iofged in on local 
m4 - 
alias: shell 

toascii - character dassification and conversion 
mi - text formattinf 
me - 
man - 

- mnitiple precision integer arithmetic. Horn, 

tp - DEC/ 
mtio - UNIX 
mt - 
rmt - remote 
mail * tend and receive 
prmail - print out waiting 
recnews - receive unprocessed articles via 
recnewi - receive unprocessed articles via 
sendnewi - send news articles via 
- encode/decode a binary file for transmission via 
nurse - receive processed news articles via 
xsend, xget, enroll - secret 

/bin/ 
mailaddr - 
biir- 

newaliaies - rebnild the data base for the 
/bitt/mail - send or receive 
from - who is my 
sendmait - send 
rmail - handle remote 


mem, kmem, mbmem, mbio - 
make - 
lockscreen - 
ar - archive and library 
intro - introduction to system 

delta - 
mkdir - 
mkdir - 
link - 
link, symink - 
mknod - 
mktemp - 

- find references in a bibliography, indxbib - 

la- 
symlink • 
syslog- 
MAKEDBV- 
script - 


memory allocator. 


logout: end session. . .. 

longjmp - non-local goto. 

look - find lines in a sorted list. 

lookbib - find references in a bibliography. 

loop. 

loop. .... 

loop..... 

loop over list of names. .. 

loopback network interface.. 

lorder - find ordering relation for an object ...... 

ipe - line printer control program. 

Ipd - line printer daemon. «... .. 

Ipq - spool queue examination program.. 

Ipr - off line print.. 

Iprm - remove jobs from the tine printer spooling * . . 

Is - list contents of directory^ .. 

Iseek, tell - move read/write pointer. .. 

Istat, fstat - get file status.* 

mi *- macro processor. . *. 

machine a snn workstation. 

machine a vax. . ... 

machine commnnication. ... 

machine-machine communication. 

machines.... 

machines. . .... 

macro processor.. 

macros. ... . 

macros, /isascii, tsgraph, tonpper, tolower. 

macros. 

macros for formatting papers.. • . . . 

macros to typeset manual. 

madd, msnb, molt, mdiv, min, moot, pow, ged, rpow . . 

mag tape formats.. 

magnetic tape interface... 

magnetic tape manipulating program.. 

magtape protocol module.. 

mail. ... 

mail.. 

mail. 

mail. .... 

mail.. 

mail. nnencode,nndecode . 

mail. 

mail. 

mail - send and receive mail. 

mail - send or receive mail among nsen. 

mail addressing description. 

mail alarm. 

mail aliases file. « • • .. 

mail among nsen. 

mail from?.. . . 

mail over the internet... 

mail received via nncp.. * . 

mailaddr - mail addressing description. 

main memory and I/O space. 

maintain program groups.. 

maintain window context until **logim’*. 

maintainer. . 

maintenance and operation commands. 

make - maintain program groups. 

make a delta (change) to an SCCS file. 

make a directoiy. 

make a directoiy file. 

make a hard link to a file. 

make a link to an existing file. .. 

make a special file. 

make a unique file name. 

make inverted index to a bibliography .br lookbib . . . 

make links. 

make symbolic link to a file.. 

make system log entiy... 

make system special files.. . . . . 

make typescript of terminal session.. . . . 

MAKEDEV - make system special files. 

makekey - generate encryption key. 

malloc, free, realloc, calloc, efree, alloca - . 


C8h(l) 

setjmp(3) 

look(l) 

indxbib(l) 

cshfl) 

cshilj 

cshfl j 

cshrl) 

lo(4) 

lorder(l) 

lpc(8) 


Iwl) 

tpri[i) 

lpnn(l) 

Ml) 

l8eek(2) 

stat(2) 

m4(i) 

8 an(l) 

vax(l) 

mptime(lC) 

rwho(lC) 

m4fl| 

esh^) 

ctype(3) 

ns 

man(7) 

mp(3X) 

tp(S) 

mtio(4) 

mt(l) 

rmt(8C) 

mail(l) 

prmail(l) 

recnewsfll 

recnew8(8) 

sendnewsfS) 

uuencode(lC) 

aurec(8) 

xsendfl) 

mail(l) 

binmail(l) 

mailaddi(7) 

biff(l) 

newalia8e8(8) 

binmail(l) 

from(l) 

sendmail(8) 

rmail(8) 

mailaddi(7) 

mem(4S) 

make(l) 

lockscieen(l) 

»i(i) 

intro(8) 

make(l) 

delta(l) 

mkdiifl) 

mkdii(2) 

link(2) 

link(3P) 

mkttod(2) 

mktemp(3) 

indxbil^l) 

i«(i) 

8 ymlink(2) 

iyslog(l) 

makedeY(8) 

8 cript(l) 

makedevfS) 

makekey(8) 

malloc(3) 
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Permuted Inies 


mfonnatioa hy keywords. 

shift: 
qnotft - 
route - m&uusJly 
mt - magnetic tape 
inet^netof, inet^ntoa - Internet address 
frexp, idexp, modf - split into 
catman - create the cat files for the 
man - macros to typeset 
whereb - locate source, binary, and/or 
man - print out manual pages; find 
man - print ont 
route - 

tee > copy standard output to 
umask: change or display file creation 
sigsetmask - set current signal 
umask - set file creation mode 
mkstr - create an error message file by 
intro - introduction to 
eqn, neqn, checkeq - typeset 
getrlimit, setriimit - control 
viimit - control 

mem, kmem, mbmem, 
mem, kmem, 
ec - SCom 10 

en - Sun 3 
as - 

precision integer/ itom, madd, msub, mult, 

bed -> convert to antique 
space. 

groups - show group 
mmap - map pages of 
munmap - unmap pages of 
malloc, free, realloc, calloc, efree, alloca - 
valloc - aligned 
mem, kmem, mbmem, mbio *** main 
vfork - spawn new process in a virtual 
abort - terminate abruptly with 
core - format of 
vmstat - report virtual 
imemtesi - stand alone 
sail - multi-user wooden ships and iron 
sort ~ sort or 
pmerge - pascal file 

mkstr - create an error 
reev, rccvfrom, recvmsg - receive a 
send, sendto, sendmsg - send a 
iemp - Internet Control 
error - analyse and disperse compiler error 
mesg - permit or deny 
sys^errlist, sys.nerr, errno - system error 
perror, gerror, iermo - get system error 
psignal, sys^siglist - system signal 
syslog - log systems 
dmesg - collect system diagnostic 

mille - play 

integer arithmetic, itom, madd, msub, mult, mdtv, 

pages, 
miscellaneous - 


C source. 


chmod - change 
getty - set terminal 
umask - set file creation 


man - macros to typeset manual. , .. 

man - print out manual pages; find manual . 

manipulate argument list. 

manipulate disk quotas. 

manipulate the routing tables. 

manipulating program. 

manipulation, /inet.makeaddr, inetjnaof, . 

mantissa and exponent. 

manual. 

manual.. 

manual for program. 

manual information by keywords. 

manual pages; find manual infonnation by keywords. • • 

manually manipulate the routing tables. 

many files.... 

mask. «... . 

mask.. 

mask. 

massaging C source. 

mathematical libraiy functions. . • • .. 

mathematics... 

msximum system resource consumption. 

maximum system resource consumption. 

mb-Multibus. .. 

mbio - main memory and I/O space.. • 

mbmem, mbio - main memory and I/O space. 

Mb/s Ethernet interface. 

Mb/s experimental Ethernet interface. . 

mefiSOOO assembler. 

mdiv, min, moat, pow, ged, rpow - multiple.. 

me - macros for formatting papers. 

media. 

mem, kmem, mbmem, mbio - main memory and I/O • • 

memberships. .. 

memory. 

memory. 

memory allocator. . 

memory allocator. 

memory and I/O space. 

memory efficient way.. 

memory image. .. 

memory image file. • .. 

memory statistics. 

memory test. 

men.... 

merge files.*. 

merger. .. 

mesg - permit or deny messages. 

message file by massaging C source. 

message from a socket. 

message from a socket. 

Message Protocol. .... 

messages... 

messages. .. 

messages, perror, .. 

messages.. • 

messages. 

messages.. 

messages to form error log. «... 

mille - play Mille Bomes. 

Mille Bomes. 

min, mout, pow, ged, rpow - multiple precision . • • • 
miscellaneous - miscellaneous useful information .... 

miscellaneous useful information pages. 

mkdir - make a directory... 

mkdir - make a directory file. 

mkfs - construct a file system. 

mknod - build special file. . ... . 

mknod - make a special file. 

mkproto - construct a prototype file system. 

mkstr - create an error message file by massaging • . , 

mktemp - make a unique file name. . 

mmap - map pages of memory. 

mode... 

mode... 

mode mask. .... 


manf7l 
man(l) 
csh(l) 
quota(2) 
route(8C) 
mt(l) 
inet(3N) 
frcxp(3) 
catman(8) 
man(7) 
wherei8(l) 
manfl' 


man(l) 

rout^SC) 

C8h(i) 

sigsetma8k(2) 

uma8k(2) 

mkstifl) 

intro(3M) 

eqn(l) 

getriimit(2) 

vlimit(3C) 

mb(4S) 

mem(4S) 

mem(4S) 

ec(4S) 

en(4S) 

. 8 ( 1 ) 

mp(3X) 

me(7) 

bcd(6) 

mem(4S) 

group8(l) 

minap(2) 

munmai^2) 

malloc(3) 

valloc(3) 

mem(4S) 

vfork(2) 

abort(3P) 

core(5) 

vm8tat(8) 

imemiestCSs) 

8 ail(6) 

8 ort(l) 

pmerge(l) 

me8g(l) 

mkstrfl) 

recY(2) 

8 end(2) 

icmp(4P) 

eiTor(l) 

mesg(l) 

perror(3) 

perror(3F) 

p8ignal(3) 

syslogfS) 

dmesgfS) 

mtlle(6) 

mille(6) 

mp(3X^ 

intro(7) 

intro(7) 

mkdirfl) 

mkdir(2) 

mkf8(8) 

mknod(8) 

mknod(2) 

mkproto(8) 

mkstifl) 

mktemp(3) 

mmap(2) 

chmod(l) 

getty(8) 

um 2 isk( 2 ) 
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Permuted Indes 


chmod - chjmge 
chmod, fchmod - ch&nge 
frexp, Idexp, 
touch - update date last 
recoveiy. eyacc- 
rmt - remote magtape protocol 
mouitori monstartup, 
execution profile, 
bdemos - demonstpite Sun 


monop - 
profile, monitor, 

cuiset - screen functions with **optimal" cunor 
col - filter reverse paper 
mount, umount - 
mount, umount - 


mtab - 
mouse - Sun 

aiithmetic. item, madd, msub, mult, rndiv, min, 
graphics/ openpl, eraN, label, line, circle, arc, 

mv- 
Iseek, tell - 

multiple precision integer arithmetic, itom, madd, 


interface, 
mti - Systech 

eyacc - modified yacc allowing 
precision integer arithmetic, itom, madd, msub, 

mb - 

vp - Ikon 10071-5 
pr - print file(8), poiiibly in 
msub, mult, mdiv, min, mout, pow, gcd, rpow - 
select - synchronous I/O 
fsplit - split a 
mti - Systcch MTI-800/1600 
sail- 
switch: 


from - who is 
getenv - value for environment 
getlog - get user’s login 
getlogin - get login 
getsockname - get socket 
mktemp - make a unique file 
pwd - print working directory 
tty - get termini 
hosts - host 
networks - network 
protocols - protocol 
services - service 
tmpnam - create a 
getpw - get 
nlist - get entries from 
nm - print 
Rename - change the 
ttyname, isatty, ttyslot - find 
ttynam, isatty - find 
getpeemame - get 
get hostname, sethostname - get/set 
hostnm - get 
hostname - set or print 
bind - bind a 
foreach: loop over list of 
ncheck - generate 


eqn, 


mode of a file... 

mode of file.*. 

modf - split into mantissa and exponent. •••*••« 

modified of a file... 

modified yacc allowing much improved error. 

module. 

moncontrol - prepare execution profile. 

monitor, monstartup, moncontrol - prepare •••••• 

Monochrome Bitmap Display. .. 

monop - Monopoly game.. 

Monopoly game.. • • • .. 

monstartup, moncontrol - prepare execution ••*••• 

more, page - browse through a text file. 

motion... 

motions.. • « .. 

mount and dismount file system. 

mount or remove file system. 

mount, umount - mount and dismount file system. • • • 
mount, umount - mount or remove file system. • • • * 

mounted file system table.. • « 

mouse. • • • *... 

mouse - Sun mouae. 

mout, pow, gcd, rpow - multiple precision integer » • • 

move, cent, point, tinemod, space, closepi - . 

move or rename files. 

move read/write pointer. • ... 

ms - text formatting macros. .. 

msub, mult, mdiv, min, mout, pow, gcd, rpow - • • • • 

mt - magnetic tape manipulating program. 

mtab - mounted file system table. 

mti - Systech MTI-800/1600 multi-iemunal . 

MTi-800/1600 multi-terminal interface. . 

mtio - UNIX magnetic tape interface. 

much improved error recovery. 

mult, mdiv, min, mout, pow, gcd, rpow - multiple • • • 

Multibus.. • • 

Multibus Venatec parallel printer interface. . 

multiple columns. 

multiple precision integer arithmetic, itom, madd, • • • 

multiplexing. .... 

multi-routine Fortran file into individual files. 

multi-terminal interface. 

multi-user wooden ships and iron men. 

multi-way command branch. 

munmap - unmap pages of memory. . 

mv - move or rename files. 

my mail from?... • 

name. 

name. 

name. 

name. 

name. 

name. 

name. 

name data base... 

name data base. « • ... 

name data base. 

name data base... 

name for a temporary file. 

name from uid. 

name list. 

namelist... 

name of a file. . 

name of a terminal. 

name of a terminal port. 

name of connected peer. 

name of current ho^.. 

name of current host. ... 

name of current host system. • • .. 

name to a socket. 

names... 

names from i-numben. .. 

ncheck - generate names from i-numbers. 

nd - network disk control.. 

nd - network disk driver. ... 

neqn, checkeq - typeset mathematics.. • . • 


chmod(3F) 

chmod(2) 

frexp(d) 

touch(l) 

eyacc(l) 

nnt(8C) 

monitors) 

monitor{3) 

bdemos(6) 

monopfG) 

monop(6) 

monitor(3) 

more(l) 

cune8(3X) 

col(l) 

mountfS) 

mountt2) 

mount(8) 

mount(2) 

mtab(5) 

mousefdS) 

mousefdS) 

mp(3X) 

plot(3X) 

m^l) 

lseek(2) 

ms(7) 

mp(3X) 

mt(l) 

mtal^S) 


mti(4S) 

mti(fS) 

mtio(4) 

eyacc(l) 

mp(3X) 

mb(4S) 

vp{4S) 

pr(l) 

m^3X) 

select(2) 

fsplitfl) 

mti(4S) 

8 aii(6) 

C8h(l) 

munmap(2) 

inT(l) 

from(l) 

getenv(3) 

getlog(3P) 

getlogin(3) 

getsockname(2) 

mktemp(3) 

pwd(l) 

Uy(l) 

host8(5) 

networksf5) 

protocols^S) 

serviccs(5) 

tmpnam(3C) 

8etpw(3) 

nliBt(3) 

nm(l) 

rename(2) 

ttyname(3) 

tt3rnam(3F) 

getpeemame(2) 

gethostname(2) 

ho8tnin(3P) 

hostname(l) 

bind(2) 

€sh(l) 


ncheckfS) 

ncheck(8) 

nd(8C) 

nd(4P) 
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Permuted Indes 


netstU - show network stains.net8tat(8) 

- check if user has news on the USENET news network, checknews .checknew8(l) 

ntohl, ntohs * convert vaines between host and network byte order, htonl, htons.b3rteorder(3N) 

nd ~ network disk control.. nd(8C) 

nd - network disk driver. .nd(4P) 

getnetbyname, setnetent, endnetent - get network entry, getnetent, getnetbyaddr, .getnetent(3N) 

gethost byname, sethostent, endhostent - get network host entry, gethostent, get host byaddr.get hos tent (3N) 

lo ~ software loopback network interface.. . ..lo(4) 

ifconhg - configure network interface parameters.ifconfig(8C) 

if - general properties of network interfaces...if(4N) 

intro - introduction to network library functions.. • • . intro(3N) 

networks - network name data base. ... network^5) 

news > USENET network news article, utility files... new8(5) 

routing - system supporting for local network packet routing.routin^4N) 

routed - network routing daemon. .routed(8C) 

netstat - show network status.net8tat(8) 

networks - network name data base.network8(5) 

creat - create a new file...creat(2) 

open a file for reading or writing, or create a new file, open .. open(2) 

newfs - construct a new file system. ..newfsfS) 

fork - create a new process.. . • . • fork(2) 

vfork - spawn new process in a virtual memory efficient way.vfork(2) 

login: login new user. . ..C8h(l) 

adduser - procedure for adding new nsers.adduseifS) 

aliases file, newaliases - rebuild the data base for the mail.newalia8e8(8) 

newfs - construct a new file system.. newf8(8] 

/continue, cd, eval, exec, exit, export, login, newgrp, read, readonly, set, shift, times, trap,/.8h(i) 

news - USENET network news article, utility files. • • . new8(6) 

news - USENET network news article, utility files.. . • . new8(5) 

expire » remove outdated news articles.expire(8) 

inews - submit news articles.. ..inew8(l) 

postnews - submit news articles. . . ..po8tnew8(l) 

readnews " read news articles. ..readnew8(l) 

sendnews * send news articles via mail. 0 endnew 8 ( 8 ) 

uurec - receive processed news articles via mail...uurec(8) 

checknews - check if user has news on the USENET news network.checknews(l) 

checknews - check if user has news on the USENET news network.checknew8(l) 

checknew8(l). newsrc - information file for readnew8(l) and .new8rc(5) 

dbminit, fetch, store, delete, firstkey, nextkey - data base subroutines. . ..dbm(3X) 

gettable - get NIC format host tables from a host.. gettable(8C) 

htableconvert NIC standard format host tables.. htable(8) 

nice • set program priority.nice(3C) 

vgriad ~ grind nice listings of programs.vgri&d(l) 

only), nice, nohup - run a command at low priority (sh .... nice(l) 

nice: run low priority process.C8h(l) 

alist - get entries from name list.nli8t(3) 

nm - print name list...nmfll 

clri - clear i- node. .c!ri(8) 

nice, nohup - run a command at low priority (sh only). • . . nice(X) 
nohup: run command immune to hangups. ...... C8h(l) 

setjmp, loagjmp - non-local goto.8etjmp(3) 

notify: request immediate notification.cshfl) 

notify: request immediate notification.C8h(l) 

relationships of screens, adjacent screens - notify the window driver of the physical.adjacent8creen8(l) 

term - terminal driving tables for nroff...term(5) 

term - terminal driving tables for nroff. .term(5) 

nroff - text formatting and typesetting.nroff(l) 

soelim - eliminate .so’s from nroff input...8oelim(l) 

tbi - format tables for nroff or troff. ...tbl(i) 

colcrt - filter nroff output for CRT previewing.colcrUl) 

deroff - remove nroff, troff, tbI and eqn constructs. .deroff(l) 

checknr ~ check nroff/troff files...checknri[l) 

network byte order, htoni, htons, ntohl, ntohs - convert values between host and .... byteorder(3N) 
b 3 rte order, htoni, htons, ntohl, ntohs > convert values between host and network . . • byteorder(3N) 

null - data sink.null(4) 

fptype - check a fioating point number.fptyp^SP) 

- get the file descriptor of an external unit number, getfd . ....getfd(3F) 

number - convert Arabic numerals to English.number(6) 

phones - remote host phone number data base.phoiies(5) 

arithmetic - provide drill in number facts. arithmetic(6) 

rand, srand - random number generator. .. rand(3C) 

/srandom, init state, set state - better random number generator; routines for changing generators. • . random(3) 

atof, atoi, atol - convert ASCII to numbers.atof(3) 

intro - introduction to system calls and error numbers.*.intro(2) 

ncheck - generate names from i- numbers.ncheck(8) 

number - convert Arabic numerals to English.numbe^G) 
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Pcrmutti Indes 


idaic, itime - reiura date or time in 
twnte» trewiD, talcipf, tstate - 177 tape 1/ 
loe - return the addresi of an 
site - eise of an 
lorder - find ordering relation for an 
stringt • find printable stringe in an 
index, rindex, Inblnk, len - tell about character 


od— 

oct - Central Data 

acct - turn accounting on or 
login - sign 

nice, nohup - mn a command at low priority (sh 
a program file including aliases and paths (csh 
create a new file, 
file, open - 
fopen, freopen, fdopen - 
lock - apply or remove an advisory lock on an 
closedir - directory operations. 

syslog, 

cont, point, linemod, space, closepl - graphics/ 
lavecore - save a core dump of the 
kgmon - generate a dump of the 
intro - introduction to system maintenance and 
tgetstr, tgoto, tputs - terminal independent 
bcopy, bcmp, bsero, ffs - bit and byte string 
telldir, seekdir, rewinddir, closedir - directory 
dkio - generic disk control 
strcpy, ftmcpy, strlen, index, rindex - string 
join - relational database 
getopt, 

cunes - screen functions with ** 
getopt, optatf, 
getopt, optaig, optind - get 
fcntl - file control 
stty - set terminal 
getsockopt, setsockopt - get and set 

- convert values between host and network byte 
lastcomm - show last commands executed in reverse 

lorder - find 
vi - screen 
cpio - copy file archives in and 
expire > remove 
a.out - assembler and link editor 

- terminate a process after flushing any pending 

fread, fwrite - buffered binary input/ 
ecvt, fcvt, gcvt - 
printf, fpritttf, sprintf - formatted 
fold - fold long lines for finite width 
colcrt - filter nroff 
stdio - standard buffered input/ 
flush - flush 
tee - copy standard 
foreach: loop 
sendmail - send mail 
exec: 

chown - change 
chown, fchown - change 
quot - summarise file system 

diag - General-purpose stand-alone utility 
stdio - standard buffered input/output 
routing - system supporting for local network 

more, 

getpagesise - get system 
pages! se - print system 
miscellaneous - miscellaneous useful information 
man - print out manual 
mmap - map 
munmap » unmap 

swapon - specify additional device for 

drum - 

vadvtse - give advice to 


numerical form. 

O. topen, tclose, tread. 

object.. • ... 

object file..... 

object library.. 

object, or other binary, file. « • • • ... 

objects. ... 

oct > Central Data octal serial card. 

octal, decimal, hex, ascii dump.. * « « 

octal serial card. 

od - octal, decimal, hex, ascii dump. *. 

off. .... . 

on... 

onintr process interrupts in command scripts. . . • . . 

only).. 

only), which - locate. 

open - open a file for reading or writing, or 

open a file for reading or writing, or create a new .... 

open a stream.... 

open file.. 

opendir, readdir, telldir, seekdir, rewinddir, . 

openlog, closelog - control system log. 

openpl, erase, label, line, circle, arc, move. 

operating system. 

operating system’s profile buffers.. . 

operation commands. 

operation routines, tgetent, tgetnum, tgetflag. 

operations. . .. 

operations, opendir, readdir, . 

operations... 

operations, strcat, stmcat, strcmp, stmcmp, . 

operator. «... 

optaig, optind - get option letter from aigv. 

optimal” cunor motion.. 

optind - get option letter from aigv. . .. 

option letter from argv. 

options. . 

options. ... 

options on sockets. .. 

order, htonl, htons, ntohl, ntohs. 

order.... 

ordering relation for an object library. 

oriented (visual) display editor based on ex. 

out.*.. 

outdated news articles.. 

output. 

output, exit . .. 

output. • .. 

output convenion... 

output conversion. 

output device. 

output for CRT previewing.. 

output package.. 

output to a logical unit.. • • . 

output to many files. 

over list of names... 

over the internet. 

overlay shell with specified command. ......... 

owner. .. . • • . 

owner and group of a file. 

ownership. 

pac - printer/plotter accounting information. ..... 

package... 

package. 

packet routing.. 

page - browse through a text file. 

page sise. 

page site. 

.. 

pages; find manual information by keywords. 

pages of memory. 

pages of memory. . .. 

pagesise - print system page sise. 

paging and swapping. 

paging device... 

paging system. 


idate(3F) 

topen(dP) 

loc(3F) 

sis^i) 

lorderfl) 

8tring8(l) 

index(3F) 

Qct(4S) 

od(l) 

oct(4S) 

od(l) 

acct(2) 

login(l) 

C8h(l) 

nice(l) 

which(l) 

openf2) 

open(2) 

fopen(3S) 

flock(2) 

directory(3) 

•y8log(3) 

plot(3X) 

savecornS) 

kgmon(8) 

iatro(8) 

termcap(3X) 

b8tring(3) 

directory(3) 

dkio(4S) 

string(3) 

ioin(l) 

getopt(3C) 

cur8es(3X) 

getoptfSC) 

getopt(3C) 

fcntl(5) 

get 80 ckopt( 2 ) 

byteorder(3N) 

la8tcomm(l) 

lorder(l) 

vi(l) 

cpio(l) 

expire(8) 

a.out(5) 

exit(d) 

fread(3S) 

ecvt(3) 

printf(3S) 

fold(l) 

colcrt(l) 

intro(3S) 

iu8h(3F) 

tw(l) 

C8h(l) 

sendmail(8) 

C8h(l) 

chown(8) 

chown(2) 

quot(8) 

p*c(8) 

di*«(8») 

intro(3S) 

routittg(4N) 

more(l) 

getpage8ise(2) 

page8ise(l) 

intro(7) 

man(l) 

mmap(2) 

munmap(2) 

page8ise(l) 

8wapon(8) 

drum(4) 

vadvi8e(2) 
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Permuted Index 


BWftpoii Jkdd a 0 wap device for interleaved 
soeketpair - create a 
col - filter rcveree 
me - macros for formatting 
vp - Ikon 10071-5 Mnltibns Versatec 
ifconfig - configure network interface 

pc- 
pxref - 
pxp- 
pmerge - 
px- 
pix- 
pi- 


getpass - read a 
passwd - change login 
passwd - 
vipw - edit the 

getpwnid, getpwnam, setpwent, endpwent - get 
getwd - get current working directory 
getcwd - get 

- locate a program file including aliases and 
grep, egrep, fgrep - search a file for a 

awk- 


popen, 

getp^mame - get name of connected 
exit - terminate a process after flushing any 

statistics. 

crontab - table of times to run 
mesg - 
ptx - 
limit: alter 
messages, 
error messages, 
sticky - executable files with 
phones - remote host 

pti - 

adjacentsereens * notify the window driver of the 

split - split a file into 
channel. 

bg: 

fish- 
mille- 
boggle - 
worm- 


pac - printer/ 

vpc - Systech VPC-2200 Vereatec printer/ 

trpfpe, fpecnt - trap and repair floating 
erase, labd, line, circle, arc, move, coat, 
fptype - check a floating 
isinf, isnan - test for indeterminate floating 
Iseck, tell - move read/write 
popd: 


ttynamf isatty - find name of a terminal 
ttytype - data base of terminal types by 
pr - print file(8), 
analyse - Virtual UNIX 

itomi madd, msub, mult, mdiv, min, mout, 
root, exp, log, loglO, 
log, loglO, pow, sqrt - exponential, logarithm, 

be - arbitrary- 

mult, mdiv, min, moot, pow, ged, rpow - multiple 
monitor, monstartup, moncontrol - 


pa^ng/swapping... swapon(2) 

pair of connected sockets.. . 8ocketpaix{2) 

paper motions. • • . ..col(l) 

papen.me(7) 

parallel printer interface. . . • ... vp(4S) 

parameters. if€onfig(8C) 

Pascal compiler. ....pc(l) 

Pascal cross-reference program. ... pxref(l) 

Pascal execution profiler. ..pxp(l) 

pascal file merger. ...pmerge(l) 

Pascal interpreter. .px(l) 

Pascal interpreter and executor.pi^(f) 

Pascal interpreter code translator.pi(l) 

passwd - change login password.passwdfl) 

passwd - password file..pas8wd(5) 

password.get passes) 

password. ... passwdfl) 

password file...pa88wd(5) 

password file.vipw(8) 

password file entry, getpwent.getpwent(3) 

pathname.....getwd(3) 

pathname of current working directory.getcwd(3F) 

paths (esh only), which.whichfl) 

pattern...8rep(l) 

pattern scanning and processing language. awk(l) 

pause - stop until signal.pau8e(3C) 

pc - Pascal compiler...pc(l) 

pciose - initiate I/O to/from a process.popen(3S) 

peer. .. getpeemame(2) 

pending output...exit(3) 

perfmott - graphical display of general system .perfmon(l) 

periodic jobs.crontab(5) 

permit or deny messages.mesgf 1) 

permuted index.ptx(l) 

per-process resource limitations.C8h(l) 

perror, gerror, termo - get system error.peiToif3F) 

peiTor, sysjerriist, sysjicrr, ermo - system .peiTor(3) 

persistent text.sticky(8) 

phone number data base.phonesfS) 

phones - remote host phone number data base.phone8(5) 

phototypesetter interpreter. .pti(l) 

physical relationships of screens.adjacent8creen8(l) 

pi - Pascal interpreter code translator.pi(l) 

pieces.spliUl) 

pipe - create an interprocess communication.pipe(2) 

pix - Pascal interpreter and executor.pix(l) 

place job in background.C8h(l) 

play “Go Fish”.fi8h(8) 

play Mille Bomes.mille(6l 

play the game of boggle.boggle(6) 

Play the growing worm game.worm(6) 

plot - graphics filten.plotflG) 

plot - graphics interface.. plot(5) 

plotter accounting information.pac(8) 

plotter and Centronics printer interface.vpc(4S) 

pmerge - pascal file merger.pmergql) 

point faults. ..trpfpe(3F) 

point, linemod, space, closepi - graphics/ openpl, • . • plot(3X) 

point number.fptyp^3F) 

point values.i8inf(3) 

pointer.l8eek(2) 

pop shell directory stack.C8h(l) 

popd: pop shell directory stack.C8h(l) 

popen, pciose - initiate I/O to/from a process. ..... popen(3S) 

port.ttynam(3F) 

port.ttytypc(5) 

possibly in multiple columns. ..p^l) 

postmortem crash analyzer.analyze(8) 

postnews - submit news articles.postnew8(l) 

pow, ged, rpow - multiple precision integer/.mp(3X) 

pow, sqrt - exponential, logarithm, power, square . . . exp(3M) 

power, square root, exp, .exp(3M) 

pr - print file(8), possibly in multiple columns.pr(l) 

precision arithmetic language. . ... bc(l) 

precision integer arithmetic, itom, madd, msub, .... mp(3X) 
prepare execution profile.monitor(3) 
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Ptrmutti InieM 


cpp - the C 

colcri - filter aroff ontpiii for CRT 
- endo & 
types- 
Ipr - off line 
foitone - 
pm- 
fiMfistot; 
jobs: 
•*ct- 
pr- 

fpr- 
fiistoiy: 
fioitid - 
butter- 
am- 

boitttttme - let or 
keyword!, mu- 
pritttettT - 
prmttii- 

pstttt - 
pagmiie- 
pwd - 
file, itrittf! - fittd 


butter - piiat lane buaer oa 
pritttcap - 
Ipc - liae 
- liae 

yp - Ikon 10071-5 Mnltibtts Venatec parallel 
VPC-2200 Venatec priater/plotter aad Ceatroaici 
Iprm - remoTe jobs from the liae 
pac- 

ype - Systecb VPC-2200 Venatec 
conyentea. 

letprioiity - get/iet profram ickeditlittf 
aice - set prof ram 
rottice - alter 
atce: ma tow 
alee, ttokap - raa a commud at low 

addiiser - 

reboot - UNIX bootstrappiaf 
alee: raa low priority 
stop: halt a job or 
.exit - terminate a 
fork - ersate a new 
fork - create a copy of this 
kill - send a sifnal to a proceu, or tenniaate a 
kill - send lifaal to a 
kill - lend a ligaal to a 
popea, pciose - initiate I/O to/from a 
wait - await completion of 
exit - tennin^^ a 

fetpfrp - fet 
killpf - send signal to a 
setpgrp - set 
getpid - get 
getpid» getppid - get 
yforit - spawn new 
ottittir 

kill - send a signal to a 
limit: alter per- 

pa- 

times - get 
wait - wait for a 
wait, waita - wait for 
ptrace - 
exit - terminate 
nnrec - receiye 
kill: kill jobs and 
gcore - get core images of running 
renice - alter priority of running 
wait: wait for background 


preprocessor • • .... 

previewing. « • • .. 

previous get of u SCCS file. 

primitive system data types. 

print. 

print a random, hopefully interesting, adage. . • * 

print u SCCS file.. 

print commud hashing statistics. . 

print current job list.. 

print current sees file editing activity. « • « « * 
print file(s), possibly in multiple columns. • • • • 

print Fortran file. . 

print histo^ event list. .. • * 

print idutifier of current host system. . 

print large buaer on printer. . 

print name list. • .. 

print name of current host system. 

print out muual pages; find manual information by 

print out the environment. • ... • • 

print out waiting mail. . 

print system facts.. 

print system page site. . 

print working directory name.. 

printable strinp in u object, or other binary, • • 

printcap - printer capability data bue. . 

printeuT - print out the environment.. 

printer. .. . • 

printer capability data base. ••*««••••• 

printer control program. . 

printer dumon.. 

printer interface. . 

printer interface, vpc - Systech . 

printer spooling queue. . 

printer/plotter accounting information. 

printer/plotter ud Centronics printer interface, 
printf, fprintf, sprintf - formatted output • • . . 

priority, getpriority.... . • 

priority.* • ... • » • « 

priority of running processes. . 

priority process... 

priority (sh only). . 

prmail - print out waiting mail. . 

procedure for adding new users. 

procedures. 

process. .. • 

process... 

process. « • • ... * • • .. 

process. 

process. 

process. ... 

process.. « . • • 

process.. • . • 

process. .. 

process.. 

process alter flushing any pending output. 

process control initialisation.. • • • • 

process group. • • • ... 

process group. • ... 

process group. .. 

process id.. 

process identification.. 

process in a virtual memory efficient way. • • • • 

process interrupts in commud scripts. 

process, or terminate a process. .. • « 

process resource limitations. 

process status. « .... 

process times. 

process to terminate.. 

process to terminate or stop.. 

process trace. .. 

process with status. .. 

processed news articles via mail. 

processes. • • ... • • 

processes.*. 

processes.. 

processes to complete. 


cpp(l) 
col^l) 
■asetU) 
t7^(6) 
IPV) , ^ 

foitutte(6) 

ssii 

cali(l) 

P*U) 

fpi(l) 

«*Ml) 

hostid(l) 

banne^G) 

nm(l) 

hostaame(l) 

mu(l) 

printettv(l) 

prmail(l; 

pstat{8) 

pagesiie(l) 

pwd(t) 

stringsfl) 

printcapfa) 

printenvfl) 

banner(GI 

printcapfS) 

lpd(f) 

vp(4S) 


Ipn^l) 

paefS) 

vpc(4S) 

priatf(SS) 

getprioriiy(2) 


renicetff, 

nicql) 

prmail(l) 

adduseiu) 

reboot(8) 

cih(l) 

cth(l) 

exit(2) 

fork(2) 

fork(8F) 

kill(l) 

kiil(2) 

kill(5F^ 

popen(S8) 

wait(l) 

exit(S) 

»it(8) 

f‘f.P5P(2) 

killpi(2) 

wtpgrp(2) 

gctpid(SF) 

fctpid(2) 

Werk(2) 

SS!! 

^(1) 

time8(3C) 

waitfdF) 

wait(2) 

ptrace(2) 


uurec(8) 

C8h(l) 

gcore(l) 

renic^S) 

CBh(l) 
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Permuted Index 


$mk - p&ttera scanning and 
halt ~ stop the 
m4 - macro 
reboot - reboot system or halt 


monstartop, moncontrol ~ prepare execution 
profit ~ execution time 
kgmon - generate a dump of the operating system’s 
gprof - display call graph 
prof - display 
pxp • Pascal execution 
cnd| etext, edata - last locations in 
ftp - file transfer 
ipe • line printer control 
Ipq - spool queue examination 
mi - magnetic tape manipulating 
pxref - Pascal cross-reference 
units - conversion 
whereis - locate sourcOi binary, and/or manual for 

cb-C 

only), which - locate a 
make ~ maintain 
nice - set 

getpriority, set priority - get/set 
indent - indent and format C 
assert - 
lint - a C 

lex - generator of lexical analysis 
ygrind ~ grind nice listings of 
xstr - extract strings from C 
fbio - general 
if - general 
arp - Address Resolution 
iemp - Internet Control Message 
ip - Internet 
tep - Internet Transmission Control 
telnet - user interface to the TELNET 
udp - Internet User Datagram 
getprotobyname, setprotoent, endprotoent - get 

inet - Internet 
rmt - remote magtape 
protocols - 

ftpd - DARPA Internet File Transfer 
telnetd - DARPA TELNET 
tftpd - DARPA Trivial File Transfer 
trpt ~ transliterate 

mkproto - construct a 
arithmetic - 
false, true - 
true, false - 


pty- 


diag - General* 
ungetc - 
pushd: 

puts, fputs - 
putc, putchar, fputc, putw - 
logical unit, 
on a stream, 
stream, putc, 

putc, putchar, fputc, 


processing language. . • .. 

processor... 

processor.. 

processor... 

prof - display profile data. 

profil - execution time profile. • . .. 

profile, monitor, • . • *. 

profile.. . .. 

profile buffers. 

profile data. • .... 

profile data. 

profiler. 

program... 

program... 

program. 

program. .. 

program.. 

program. 

program. 

program. 

program beautifier. 

program file including aliases and paths (esh. 

program groups. 

program priority. 

program scheduling priority. 

program source. 

program verification. .. 

program verifier. ... 

programs. 

programs. . .. 

programs to implement shared strings. . .. 

properties of frame bnffen. 

properties of network interfaces. . .. 

Protocol. . . . .. 

Protocol... 

Protocol. 

Protocol. 

protocol.. 

Protocol. . • « • ... • . • 

protocol entry, getprotoent, getprotobynumber, . • . . 

protocol family. 

protocol module. 

protocol name data base.. 

Protocol server. ... 

protocol server. . 

Protocol server. 

protocol trace... 

protocols - protocol name data base. 

prototype file system. 

provide drill in number facts. 

provide truth values... 

provide truth values. 

prs - print an SCCS file. 

ps ~ process status. 

pseudo terminal driver. • • ... . . 

psignal, sys^siglist - system signal messages. 

pstat ~ print system facts. 

pti - phototypesetter interpreter. 

ptrace - process trace... 

ptx - permuted index. 

pty - pseudo terminal driver. 

purpose stand-alone utility package.. • . . 

push character back into input stream. 

push shell directory stack. 

pushd: push shell directory stack. 

put a string on a stream. • . • .. 

put character or word on a stream. 

putc, fputc - write a character to a FORTRAN , . • , 
putc, putchar, fputc, putw - put character or word « . • 
putchar, fputc, putw - put character or word on a . . . 

puts, fputs ~ put a string on a stream. 

putw - put character or word on a stream. 

pwd - print working directory name. 

px - Pascal interpreter. . 

pxp - Pascal execution profiler. 

pxref - Pascal cross-reference program. 


awk(l) 

lkalt(8) 

m4(l) 

reboot(2) 

prof(l) 

profil(2) 

monitoi(3) 

profil(2) 

kgmon(8) 

eprof(l) 

prof(l) 

P*P(1) 

«iid(3) 

ftp(lC) 

lpc(8) 

ipqh) 

mt(i) 

pxrelYl) 

units(l) 

wherei8(l) 

cb(l) 

which(l) 

make(l) 

nice(3C) 

getpriority(2) 

indent(l) 

assert(3) 

lint(l) 

lcx(l) 

vgrind(l) 

X8tr(l) 

fbio(4S) 

if(4N) 

arp(4P) 

icmp(4P) 

ip(4P) 

tcp(4P) 

telnet(lC) 

udp(4P) 

getprotoent(3N) 

inet(4F) 

rmt(8C) 

protocol8(5) 

ftpd(8C) 

telnetd(8C) 

tftpd(8C) 

trpt(8C) 

protocol8(5) 

mkproto(8) 

arithmetic(6) 

fal8e(l) 

true(l) 

pr8(l) 

ps(l) 

pty(<) 

p9igiial(3) 

pstat(8) 

pti(l) 

ptrace(2) 

Ptx(l) 
pty(4) 
diag(88) 
unget c(3S) 


C8h(l) 

put8(3S) 

putc(3S) 

putc(3F) 

putc(3S) 

putc(3S) 

puts(3S) 

putc(3S) 

pwd(l) 

Px(l) 

pxp(l) 

pxref(l) 
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Permuted IndtM 


insqae, remqat - infeii/remove etemeiki from * 
Iprm - remove jobs from ibe line printer spooling 

Ipq • spool 


qsort - 
^Olt - 


quoin * mnnipnlnte disk 
setqnotn - ennble/disnble 

rnin - nnimnted 

fortune * print n 
rnniib - convert nrebives to 
rnnd) sinnd - 

random, snndom, initstnte, setstnte * better 
rnndom nnmber genemtor; rontinei for changing/ 


rntfor - 

n itrenm to n remote commnad. 


getput - 
source: 
rend, rendv - 
rendnewB - 

wait/ /cd, evni, exec, exit, export, login, aewgip, 

rendlink - 

directory operations, opendir, 
open - open a tie for 


newsre * information file for 
/cd, eval, exec, exit, export, login, newgrp, read, 

read, 

Iseek, tell - move 
setregid * set 
setreuid - set 
malloc, free. 


rc * command script for auto¬ 
reboot - 
fastboot, futbalt - 
newaliases - 
reev, recvfrom, recvmsg - 
mail - send and 
/bin/mail - send or 
uurec - 
recnews - 
recnews - 
rmail • handle remote mail 


rehash: 
utmp, wtmp - login 
eyacc - modified yacc allowing much improved error 

socket, 
socket, reev, 
reev, recvfrom, 
evaJ: 
re.comp, 
documents, 
pxref - Pascal cross¬ 
index to a bibliography .br lookbib - find 
refer - find and insert literature 
relcomp, rejcxec - 


comm - select or 


qsort ~ quick sort.. 

qsort - quicker sort. 

queue. .... 

queue... 

queue examination program... « • • • 

quick sort.. 

quicker sort. .. 

quia - test your knowledge. 

quot - summarise file system ownership. 

quota - manipulate disk quotas. 

quotas.. • • • 

quotas on a file system. « * • .. 

rain - animated raindrops display. . 

raindrops display... 

rand, srand - random number generator. . 

random, hopefully interesting, adage. 

random libraries. 

random number generator. 

random number generator, routines for changing/ * • • 

random, srandom, initstate, setstate - better . 

ranlib * convert archives to random libraries. . • • * • 

ratfor - rational Fortran dialect... 

rational Fortran dialect... 

re - command script for auto-nboot and daemons. • • • 
remd, rresvport, mserok * routines for returning * • * • 

rep - remote file copy. 

rdate - set system date from a remote host. 

read a password. . . • ... • 

read commands from file. 

read input.*. 

read news articles... 

read, readonly, set, shift, times, trap, imask, . 

read, readv - read input.. .. 

read value of a symbolic link.. 

readdir, telldir, seekdir, rewinddir, closedir -. 

reading or writing, or create a new file.. * • • 

readlink - read value of a symbolic link. ••«••••• 

readnews - read news articles... 

readnews(l) and checknews(l).. • • 

readonly, set, shift, times, trap, umask, wait -/ * • • « 

readv - read input. • ... 

read/write pointer. .. 

real and effective group ID.. • * « • 

real and effective user ID*s. 

realloc, calloc, efree, alloca - memory allocator. . . • » • 

reboot - reboot system or halt processor. . 

reboot - UNIX bootstrapping procedures. 

reboot and daemons. 

reboot system or halt processor. • ... * • • • 

reboot/halt the system without checking the disks. . • • 

rebuild the data base for the mail aliases file.. 

receive a message from a socket. 

receive mail.. « • . .. 

receive mail among .. 

receive processed news articles via mail. 

receive unprocessed aiticles via mail.. • • • . 

receive unprocessed aiticles via mail. 

received via uuep. . • . .. 

recnews - receive unprocessed articles via mail. 

recnews - receive unprocessed artides via mail.. 

re.comp, re.cxec - regular expression handler.. 

recompute command hash table. 

records... 

recoveiy. . 

reev, re^rom, recvmsg - receive a message trom a • » • 
recvfrom, recvmsg « receive a message from a • • • • • 

recvmsg - receive a message from a socket.. 

re-evaluate shell data.. • • 

re.exec ~ regular expression handler. 

refer - find and insert literature references in . 

reference program.. 

references in a bibliography. /- make inverted. 

references in documents. ... 

regular expression handler. . 

rehash: recompute command hash table. . 

reject lines common to two sorted files.. 


qsoitffiF) 

qsoit(3) 

insquefS) 

Ipr^l) 

ip<i(») ^ 

qaoitfSF) 

q 80 it( 3 ) 

quif(6) 

quot(8) 

quotaf2) 

qnota(2) 

setquot^2) 

rainffi) 

rain(6) 

rand(3C) 

foituneffi) 

ranlib(l) 

rand(^) 

randomfSl 

raadom(3) 

ranliUl) 

ratforil) 

ratfoi\l) 

re(8) 

rcmd(3N) 

rcp(iC) 

rdate(8) 

Ketpua(3) 

wkm 

read(2) 

readnew8(l) 

sh(l) 

read(2) 

readlink(2) 

director's) 

open(2) 

readlink(2) 

readnew8(l) 

newsrefS) 

sh(l) 

fead(2) 

l8eek(2) 

setregid(2) 

setreuid(2) 

mailoc(3) 

rebootf2) 

reboot(8) 

rc(8) 

rebMt(2) 

fastboot(8) 

newalias^8) 


mail(l) 

binmail(l) 

nurec(8) 

recnewsfl) 

recnews(8) 

niiail(8) 

recnewslll 

recnewB(8) 

regex(3) 

e,k(0 

c»k(l) 

regex(3) 

refer(l) 

pxreQl) 

indxbiMl) 

refer(l) 

regex(3) 

csh(l) 

cornual) 
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PcrmuUd Index 



lorder - find ordering relation for an object library. 

join -* relational database operator. 

- notify the window driver of the physical relationships of screens, adjacentscreens • . 

sigpanse atomically release blocked signals and wait for interrupt. 

strip - remove symbols and relocation bits. 

leave - remind you when you have to leave. . . . • 

calendar - reminder service. , .. 

remote - remote host description file. 

ruierok - routines for returning a stream to a remote command, remd, rresvport, • • . • . 

lexec - return stream to a remote command. 

rexecd - remote execution server. « .. 

rep - remote file copy. 

rdate - set system date from a remote host... 

uusend - send a file to a remote host. 

remote - remote host description file. 

phones - remote host phone number data base. 

riogin remote login.. 

ifogind - remote login server.. 

rmt - remote magtape protocol module. 

rmait • handle remote mail received via uuep. . .. 

rsh > remote shell. ... 

rshd - remote shell server.. « . • 

tip, cu - connect to a remote system. • . .... 

nndel - remove a delta from an SCCS file. 

unlink * remove a directoiy entry. • .. 

imdir - remove a directory file. 

unalias: remove aliases. 

flock - apply or remove an advisory lock on an open file. • . 

colrm - remove columns from a file. ... • 

unlink - remove directory entry. 

insque, remque - insert/ remove element from a queue. 

unsetenv: remove environment variables. 

mount, umount ^ mount or remove file system. . 

Iprm ^ remove jobs from the line printer spooling queue, 
deroff - remove nroff, troff, tbi and eqn constructs. . . 
expire - remove outdated news articles. 

Uttlimit: remove resource limitiations.. • . 

strip - remove symbols and relocation bits. 

rmdir, rm - remove (unlink) directories or files. 

rm, rmdir - remove (unlink) files or directories. 

insque, remque - insert/remove element from a queue. 

rename - change the name of a file. 

rename - rename a file. . 

rename - rename a file. .... 

mv move or rename files. 

renice - alter priority of running processes. 

file system consistency check and interactive repair, fsck . 

trpfpe, fpeent - trap and repair floating point faults. 

while: repeat commands conditionally. 

repeat: execute command repeatedly. 

uniq report repeated lines in a file.. . • • 

repeat: execute command repeatedly. 

yes - be repetitively affirmative. 

df > report free disk space on file systems. • . • . 

iostat - report I/O statistics. 

uniq - report repeated lines in a file. 

vmstat - report virtual memory statistics. 

fseek, ftell - reposition a file on a logical unit. 

fseek, ftell, rewind - reposition a stream.. . . 

notify, request immediate notification. 

state, reset - reset the teletype bits to a sensible . , 
reset - reset the teletype bits to a sensible state. • . 

arp - address resolution display and control. 

arp • Address Resolution Protocol. 

getrlimit, setrlimii - control maximum system resource consumption. 

vlimit - control maximum system resource consumption. 

limit: alter per-process resource limitations. .. 

unlimit: remove resource limitiations. 

getrusage - get information about resource utilisation. 

vtimes - get information about resource utilisation. 

restore - incremental file system restore. 

restore - incremental file system restore. . • 

suspend: suspend a shell, resuming its superior. 

getarg, iaige - return command line arguments. 

idate, itime - return date or time in numerical form. . , • 

' flmin, flmax, dfimtn, dflmax, inmax - return extreme values. 
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lorder(l) 

join(l) 

adjacent8creens(l) 
8igpau8e(2) 

8trip(l) 

leavc(l) 

calendar(l) 

remote(5) 

rcmd{3N) 

rexec(3N) 

rexecd(8C) 

rcp(lC) 

rdate(8) 

uu8end(lC) 

remote(5) 

phone8(5) 

rlogin(lC) 

rlogind(8C) 

rmt(8C) 

rmail(8) 

r8h(lC) 

rshd(8C) 

tip(lC) 

rmdel(l) 

unlink(3F) 

rmdir(2) 

C8h(l) 

fiock(2) 

colrm(l) 

unlink(2) 

in8que(3) 

C8h(l) 

mount(2) 

lprm(l) 

dero^l) 

expire(8) 

C8h(l) 

8trip(l) 

rmdir(l] 

rm(l) 

in8que(3) 

rename(2) 

renamejsP) 

rename(dF) 

mv(i) 

renice(8) 

fBck(8) 

trpfpe(3F) 

C8h(l) 

C8h(l) 

uniq(l) 

C8h(l) 


iostat(8) 

uniq(l) 

vm8tat(8) 

f8eek(3F) 

f8eek(3S) 

C8h(l) 

rc8et(l) 

resetjl) 

arp(8C) 

arp(4P) 

getrlimit(2) 

vlimit(3C) 

C8h(l) 

C8b(l) 

getru8age(2) 

vtimes(3C) 

restore{8) 

restore(8) 

C8h(l) 

getarg(3F) 

idate(3P) 

rang^3F) 
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Permuted Indeg 


rexec- 
loc - 

rcmd, rreiyporii niaerok - roatiaci for 

rcT - 

Uitcomm - show lut commudr executed in 

col - filter 
fseeki ftell, 
opesdir, rexddiri telidir, seekdir, 


itrcmp, ftmcmp, rtrcpj. itncpy, itrleXi index, 

objecti. index, 


nadir, 


m, 


ckwo - Try to oicnpe to killer 

pow, iqit - exponentiot, loiftritbm, power, iqnnre 

chroot - ckonge 


fsptit - fplii n mnlti- 
tfoto, tpnti - terminni independent operation 
•etiiaie - better random number generator, 
command, rcmd, mivpoit, raierok - 
- lyitem inpportinf for local network packet 
packet routing, 
routed - network 
route - manually manipulate the 
Horn, madd, miub, mult, mdiu, aiin, mout, pow, gcd, 
ftream to a remote command, rcmd, 


nice, nokup - 
nobup: 
nice: 
rofibib - 

crotttab - table of timei to 
gcore - get core imaget of 
renice - alter priority of 

remote command, redid, rreirport. 


ec - 3Com 10 Mb/ 
en - Sun 3 Mb/ 
pr - print fil^ 


larecore- 

lyvtem. 

brk, 

at - Driver for Syagen 
seandir, alpbaiort - 

converaion. 
awk > pattern 
IS - silog 8530 

ede - change the delta commentary of an 
comb * combine 
delta - make a delta (change) to an 
get - get a veteion of an 
pn - print an 
tmdel - remove a delta from an 
sccadiff - compare two veraiona of an 
accafile - format of 


return stream to a remote command. . 

return the addreaa of an object. 

returning a atream to a remote command. 

rev - revene linea of a file. 

reverae linea of a file. 

revene order. 

reverae paper motiona. 

rewind - repoaitiott a atream.. 

rewinddir, cloaedir - directory operationa. 

rexec - return atream to a remote command. 

rexecd - remote execution aerver. . 

rindex - atring operationa. aticat, atmeat, . 

rindex, Inblnk, len - tell about character . 

riogin - remote login. 

rlogind - remote login aerver. . . * . .. 

rm - remove (unlink) diiectoriea or filea.. • 

rm, rmdir - remove (unlink) filea or directoriea. • • • « 

rmail - handle remote mail received via uuep. . 

rmdel - remove a delta from an SCCS file. 

rmdir - remove (unlink) filea or diiectoriea. 

rmdir - remove a directory file.. • 

rmdir, rm - remove (unlink) directoriea or filea. 

rmt - remote magtape protocol module.. 

robota. 

roffbib - run off bibliographic databaae. 

root, exp, log, loglO, . 

root directory. . 

route - manually manipulate the routing tablea. 

routed - network routing daemon. ... • 

routine Fortran file into individual filea.. 

routinea. tgetent, tgetnum, tgetflag, tgetatr. 

routinea for changing generaton. /initatate, 

routinea for returning a atream to a remote ••••*• 

routing, routing . 

routing • ayatem auppoiting for local network . 

routing daemon. 

routing tablea. 

rpow - multiple preciaion integer arithmetic. 

neavpoit, ruaerok • routinea for returning a. 

rah - remote ahell. 

nhd - remote aheH aerver. 

run a command at low priority (ah only). . 

run command immune to hangupa.. 

run low priority proceaa. 

run off bibliographic databaae.. 

run periodic joba. ... 

running proceaaea... 

running proceaaea.. • • • 

ruptime - ahow boat atatua of local machinea. 

ruaerok - routinea for returning a atream to a . 

rwho - who*a logged in on local machinea. 

rwhod - ayatem atatua aerver. . 

a Ethernet interface.. • • 

a experimental Ethernet interface. 

a), poaaibly in multiple columna. 

aa, aceton - ayatem accounting. . 

aact - print current SCCS file editing activity.. 

aail - multi-uaer wooden ahipa and iron men. 

aave a core dump of the operating ayatem. 

aavecoie - aave a core dump of the operating . 

abrk change data aegment aiie. .. 

SC 4000 (Archive) Tape Controller.. 

acan a directory. . 

acandir, alphaaort - acan a directory. • ... 

acanf, fac^, aacanf - formatted input .. « 

acanning and proceaaing language. .. 

see aerial comunicationa driver. . 

acca - front end for the .SM SCCS aubayatem. 

SCCS delta. 

SCCS deltaa.. . , 

SCCS file. . • . ... 


SCCS file. 
SCCS file. 
SCCS file. 
SCCS file. 
SCCS file. 


rexec(3N) 
loc(3F) 
rcmd(3N) 
rcv(l^ 


:i) 

la8tcomm(l) 

col(l) 

f8eek(3S) 

director^O) 

rexec(3N) 

rexecd(8C) 

atring(3) 

iadex(3F) 

rtogin(lC) 

riogind(8C) 

rmdir(lj 

nii(l) 

rmail(8) 

rmdel(l) 

m(l) 

rmdirf2i 

rmdirfl) 

rmt(8C) 

chaae(6) 

roffbi^l) 

exp(3M) 

chroot(2) 

ronte(8C) 

routedfSC) 

faplit(l) 

termcap(3X) 

raadom(3) 

rcmd(3N) 

routingf4N) 

routin^4N) 

ronted(8C) 

route(8C) 

mp(3X) 

rcmd(3N) 

r8h(lC) 

rahd(8C) 

nice(l) 

cah(l) 

C8h(l) 

roffbib(l) 

crotttab(5) 

gcore(l) 

reni€e(8) 

ruptime(lC) 

rcmd(3N) 

rwho(lC) 

rwhod(8C) 

ec(4S) 

aail(O) 

aavecorefS) 

aavecore(8) 

brk(2) 

at(4S) 

acandir{3) 

acandir(3) 

acanf(3S) 

.wk(l) 

ia(4S) 

acc8(l) 

cdc(l) 

combi 1) 

delta(l) 

Killi 

rmdel(l) 

8CC8diff(l) 

accafile(5) 
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Permuted Index 


- undo ft previoas gel of fta SCCS file...iinget(l) 

vai * T&lidftte SCCS file.yftl(l) 

Sftcl - priftl cuirenl SCCS file editing ftctivity. • • ..eftct(l) 

ftdmia - create and administer SCCS files.admin(l) 

8CC8 - front end for the .SM SCCS subsystem. .8cc8(l) 

sccsdiff - compare two versions of an SCCS file.8cc8di£f(l} 

sccsfile - format of SCCS file.scc8file(5) 

alarm - schedule signal after specified time. • ..alarm(3C) 

getpriority, setpriority - get/set program scheduling priority. .. • . • getpriority(2) 

clear - clear workstation or terminal screen..clear{l) 

curses > screen functions with **optimar* cunor motion.cnr8es(3X) 

ex. VI - screen oriented (visual) display editor based on.vi(l) 

the window driver of the physjcal relationships of screens, adjacentscreens - notify.adjacent8creen8(l) 

adbgen - generate adb script...adbgenlS) 

script - make typescript of terminal session.8cript(l) 

rc - command script for auto-reboot and daemons.rc(8) 

onintr process interrupts in command scripts. » . ..C8h(l) 

Controllers, sd - Disk driver for Adaptec ST-306 Disk ••••••• sd(4S) 

grep, egrep, fgrep > search a file for a pattern.6rep(l) 

xsend, xget, enroll - secret mail.... xsendfl) 

sed - stream editor...sed(l) 

operations, opendir, readdir, telldir, seekdir, rewinddir, closedir - directory .director]r(3) 

brk, sbrk - change data segment sise.brk(2) 

select - synchronous I/O multiplexing.select(2) 

comm - select or reject lines common to two sorted files.comm(l) 

case: selector in switch. « C8h(l) 

uusend - send a file to a remote host.uu8end(lC) 

send, sendto, sendmsg - send a message from a socket.send(2) 

kill - send a signal to a process. • . . ..killf3P) 

kill - send a signU to a process, or terminate a process. • • . kill(l) 

mail - send and receive mail.mail(l) 

sendmail- send mail over the internet. ..8endmail(8) 

sendnews - send news articles via mail.. • • sendnew8(8) 

/bin/mail - send or receive mail among users.binmail(i) 

socket, send, sendto, sendmsg - send a message from a .... send(2) 

kilt - send signal to a process.kill(2) 

killpg - send signal to a process group.killp^S) 

aliases -> aliases file for sendmail. • ..aliase^S) 

sendmail - send mail over the internet.8endmatl(8) 

send, sendto, sendmsg - send a message from a socket.8end(2) 

sendnews - send news articles via mail. . ..8endnew8(8) 

send, sendto, sendmsg - send a message from a socket.8end(2) 

reset»reset the teletype bits to a sensible state. ..reset(l) 

oct" Centrd Data octal serial card...oct(45) 

88 - silog 8530 see serial comnnications driver.88(4S) 

comsat - biff server. ...com8at(8C) 

ftpd • DAEPA Internet Fite Transfer Protocol server. .ftpd(8C) 

rexecd > remote execution server. ...rexecd(8e) 

riogind - remote login server. .rlogind(8C) 

nhd - remote shell server. ..r8hd(8C) 

rwhod - system status server. .rwhod(8C) 

telnetd - DAEPA TELNEH* protocol server. ...telnetd(8C) 

tftpd - DAEPA Trivia! File Transfer Protocol server. ..tftpd(8C) 

timed - DAEPA Time server. ...timed(8C) 

servers - inet server data base...8erver8(5) 

servers - inet server data base.server8(5) 

calendar ~ reminder service.calendar(l) 

services - service name data base.8ervice8(5) 

inetd - internet services daemon.inetd(8C) 

logout: end session...C8h(l) 

script - make typescript of terminal session.8cript(l) 

ascii - map of ASCII character set. . ..as€ii(7) 

stty, gtty - set and get terminal state.stty(3C) 

sigstack • set and/or get signal stack context.. 8ig8tack(2) 

set: change value of shell variable.C8h(l) 

sigsetmask - set current signal mask.8ig8etma8k(2) 

gettimeofday, settimeofday - get/ set date and time. ...gettimeofday(2) 

umask - set file creation mode mask..ama8k(2) 

utime - set file times.utime(3C) 

utimes - set file times.utimes(2) 

setgroups - set group access list.8etgroaps(2) 

gethostname, set hostname - get/ set name of current host.gethostname(2) 

getsockopt, setsockopt - get and set options on sockets.get8ockopt(2) 

hostname - set or print name of current host system.ho8tname(l) 

setpgrp - set process group.8etpgrp(2) 

nice - set program priority.nice(3C) 
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Permuted Indes 


Ceipriorily, aeiprioriiy - get/ 
eeiregid - 
eeirenid - 

/exec, exit, export, login, newgrp, rexd, reedonlj, 

rdxte - 
getty - 
0tty - 
dxte - d»pUy or 
letenid, setmid, setgid, eetegid, setigid - 
vlimit - get end 
getitimer, vetitimer - get/ 
setenv: 
tonttreuB. 
strexm. Mtbnf, 
•eUid, setevid, letraid, eetgid, 

user end gronp ID. eetnid, 
die/ getfsent, getfupec, geifriile, getfatype, 
•etvid, eetcttid, aetruid, 
getgrent, getgrgid, geigrenm, 

getheitent, getboatbyaddr, gethoatbyn&me, 
getboatname, 
getitimer, 


crypt, 
aetbnf, letbaffer, 
getaeteat, getaetbyaddr, getaetbyaame, 

getpriority, 

getprotoeat, getprotobjraamber, getprotobyaame, 
getpweat, getpwaid, getpwaam. 


letaid, leteaid, aetraid, aetgid, aet^d, 
coaanmptioa* getrlimit, 
groap ID. aetaid, aeteaid, 
getaenreat, getaervbypoit, getaenrbyaame, 

getaockopt, 

roatiaea for ebaagiag/ random, arandom, iaitatate, 

gettimeofday, 
- aet aaer and groap ID. 
cd, eral, exec, exit, export, login, aewgrp, read,/ 
nice, aobap - ran a command at low priority ( 
- extract atriaga from C programa to implement 
ckab * change defaalt login 
exit: leave 
rab - remote 
ayatem iaaae a 
eab-a 
eval: re-evalaate 
popd: pop 
paabd: paab 
aliaa: 

anapend: anapead a 
rabd - remote 
aet: change valae of 
O: arithmetic on 
aaaet: diacard 
exec: overlay 

exit, export, login, aewg^, read, readonly, aet, 
aail - mnlti-naer wooden 
groapa - 
raptime - 
uptime - 
laatcomm - 
netetat - 
shutdown - 


connection. 

login - 
pause - atop until 
aignal - change the action for a 


aet program achednling priority. 

aet real and effective group ID. 

aet real and effective user lD*a. 

aet, ahift, times, trap, umaak, wait - command/ • • « • 

aet ayatem date from a remote boat. 

aet terminal mode.. 

aet terminal options.. 

aet the date. 

act user and group ID. aetuid, • .. 

aet user limits... 

set value of interval timer.. • .. 

set variable in environment.. • • • • 

setbuf, setbuffer, setlinebuf - assign buffering . 

setbnffer, setlinebuf - aaaign buffering to a. 

aetegid, setrgid - set user and group ID.. 

setenv: set variable in environment. 

seteuid, setluid, setgid, aetegid, setrgid * set. 

setfsent, endfsent • get file system descriptor . 

setgid, aetegid, aetif id - set user and group ID. 

setgrent, endgrent - get group file entry. 

setgroups - set group access list.. • • 

•ethostent, endhostent - get network host entry. * • * « 

aethoatname - get/set name of current host. 

setitimer - get/set value of interval timer... , 

setjmp, longjmp - aon*local goto.. . • • 

setkey, encrypt - DES encryption. • . • .. 

setlinebuf - assign buffering to a stream.. « • 

setnetent, endnetent - get network entry. . 

setpgrp ' set process group. 

setpriority - get/set program scheduling priority. • • • * 

aetprotoent, endprotoent - get protocol entry. 

setpwent, endpwent - get password file entry. • • • • • 
aetquota - enable/diaable quotas on a file sjrstem. • * « 
setregid - set real and effective group ID. 

aetreuid * aet real and effective user ID’s. 

setrgid - set user and group ID. 

setrlimit - control maximum system resource • • * • • 

setruid, setgid, setegid, setrgid - set user and . 

setservent, endservent - get service entry.. • • 

setsockopt - get and set options on sockets. «••••• 

setstate - better random number generator; . 

settimeofday - get/set date and time. • • • .. 

setuid, seteuid, aetruid, aetgid, setegid, setrgid . 

ah, for, case, if, while,., break, continue, • .. 

ah only). .. * * * * . 

shared strings, xatr . 

shell. 

shell. 

shell.. . • . 

shell comnund. .... 

shell (command interpreter) with C-like sjmtax. « • « • 

shell data. .. 

shell directory stack. • « .... 

shell directory stack.. • • • 

shell macros. 

shell, resuming its superior. 

shell server.. 

shell variable. .. 

shell variables. .. 

shell variables.. * « • .. 

shell with specified command. 

shift: manipulate argument list. 

shift, times, trap, umask, wait - command/ /exec, . • « 

ships and iron men. 

show group memberships. 

show host status of locU nuchtnes.. » • 

show how long system has been up. 

show last commands executed in reverse order.. 

show network status.. • • . 

shut down part of a full-duplex connection. 

shutdown * close down the system at a given time. • • • 

shutdown - shut down part of a full-duptex . 

sigblock - block signals. .. 

sign on. « .. 

signal. • • • • .. 

signal. 


getpriority(2) 

setregid(2) 

setreuid(2) 

.k(i) ^ 

rdatefS) 

ffctW) 

stty(l) 

dat^l) 

8etuid(3) 

ulimit(3C) 

getitimer(2) 

csh(l) 

setbuf(dS) 

setbuf(3S) 

setuid(3) 

coh(l) 

setuid(3) 

getf8ent($) 

setuid(3} 

getgrent(3) 

setgroup8(2) 

getho8tent(3N) 

gethostname(2) 

gctttimei(2) 

setjmp(3) 

crypt(3) 

setbuf(3S) 

getnetent(3N) 

setpgrp(2) 

getpriority(2) 

getprotoent(3N) 

getpwent(3) 

setquota(2) 

setregid(2) 

8etreuid(2) 

8etuid(3) 

getriimtt(2) 

8etuid(3) 

getserveBt(3N) 

getsockopt(2) 

randoiii(3) 

gettimeofday(2) 

setuid(3) 

•Ml) 

nice(l) 

X8tr(l) 

Ch8h(l) 

C8h(l) 

nh(lC) 

systenr(3) 

ah(l) 

cshfli 

cshfl) 

cshili 

cshilj 

C8h(l) 

nhd(8C) 

cshfl) 

cshtli 

cshfli 

cshfli 

cshfl) 

•Ml) 

sail(6) 

croaiMl) 

ruptime(lC) 

uptime(l) 

lastcomin(l) 

netstat(8) 

shntdownf2) 

shutdownfSi 

shutdown(2} 

sigblock(2) 

login(l) 

paus^ac) 

signal(3F) 


January 1984 


- xxxvt - 


Sun System Release 1.1 







































































Permuted Index 


ftlarm - schedule 
sigafti - simplified software 
sigvee - software 
sigsetmask > set current 
pstgaal, sys^iglist - system 
sigstack - set aad/or get 
kill - send 
kill - send a 
killpg - send 
kill - send a 
sigblock - block 
sif pause - atomically release blocked 
wait for interrupt. 


signal - 

trigonometric functions. 

null - data 

brk, sbrk - change data segment 
getdtablesise - get descriptor table 
getpagesise - get system page 
pageeise ~ print system page 

siie - 


sees - front end for the 
ip - Disk driver for Interphase 2180 
xj - Disk driver for Xylogics 
spline - interpolate 

snake, 

accept ~ accept a connection on a 
bind - bind a name to a 
connect - initiate a connection on a 
listen - listen for connections on a 
reev, recvfrom, lecvmsg - receive a message from a 
send, sendto, aendmsg - send a message from a 

getsockname - get 

getsockopt, setsockopt - get and set options on 
socketpair * create a pair of connected 


lo - 

signal - simplified 
sigvec - 
Canfield, cfscores ~ the 
qsort - quicker 
qsort ~ quick 
tsoit topological 

sortbib - 
sort - 

comm - select or reject tines common to two 
look - find tines in a 
soelim - eliminate 
indent - indent and format C program 
- create an error message file by massaging C 
whereis ~ locate 

mem, kmem, mbmem, mbio - main memoiy and I/O 
line, circle, arc, move, cont, point, linemod, 
df ~ report free disk 
expand, nnexpand - expand tabs to 
way. vfork - 
exec: overlay shell with 
head - display first few lines of 
truncate, ftruncate > truncate a file to a 
alarm - schedule signal after 


signal - change the action for a signal. 

signal - simplified software signal facilities. 

signal after specified time. 

signal facilities. 

signal facilities. 

signal mask. 

signal messages. ... • .. 

signal stack context. 

signal to a process. • • .. 

signal to a process. 

signal to a process group. 

signal to a process, or terminate a process. 

signals. . 

signals and wait for interrupt. . 

sigpause - atomically release blocked signals and • • « • 

sigsetmask - set cuirent signal mask. 

sigstack > set and/or get signal stack context. 

sigvec - software sign^ facilities. 

simplified software signal facilities. 

sin, cos, tan, asin, acos, atan, atan2 -. 

linh, cosh, tanh - hyperbolic functions. 

sink.. • .. 

sire. 

sise.. • .. 

sise... 

sise. 

sise * sise of an object file. . • .. 

sise of an object file. 

sleep - suspend execution for an interval. 

sleep - suspend execution for an interval. 

sleep ~ suspend execution for interval. 

.SM sees subsystem. 

SMD Disk eontroller. 

SMD Disk eontrollers. 

smooth curve. 

snake, snscore - display chase game. . 

snscore - display chase game. 

socket... 

socket. 

socket.... • « , 

socket. 

socket. 

socket.. • 

socket - create an endpoint for commnnication. 

socket name. 

socketpair - create a pair of connected sockets. 

sockets. 

sockets.. 

soelim - eliminate .so*s from nroff input. 

software loopback network interface. 

software signal facilities. 

software signal facilities. 

solitaire card game canfield. 

sort... 

sort.... 

sort.. • « .. 

sort - sort or merge files. 

sort bibliographic database. 

sort or merge files. 

sortbib - sort bibliographic database. . 

sorted files. 

sorted list. 


8igiiaI(SF) 

signalfd) 

alarm(3C) 

8ignal(3) 

8igvec(2) 

8ig8etma8k(2) 

p8ignal(3) 

8ig8tack(2) 

kin(2) 

kill(3P) 

kil!pg(2) 

kill(l) 

8igblock(2) 

8igpau8e(2) 

8igpau8e(2) 

8ig8etma8k(2) 

sigstack(2) 

8igvec(2) 

8ignal(3) 

8in(3M) 

8inh(3M) 

null(t) 

brk(2) 

get<ltablesire(2) 

getpage8iie(2) 

page8ize(l) 

8leep(l) 

sleep?3F) 

sleep(3) 

8CC8(1) 

ip(4S) 

xy(4S) 

8pline(lG) 

snakefe) 

8nake(6) 

accept(2) 

bind(2) 

connect(2) 

li8ten(2) 

recv(2) 

8end(2) 

socket(2) 

get8ockname(2) 

8ocketpair(2) 

get8ockopt(2) 

8ocketpair(2) 

8oelim(l) 

lo(4) 

8ignal(3) 

8igvec(2) 

canfield(6) 

q80ii(3) 

q80it(3F) 

t8ort(l) 

8ort(l) 

8ortbib(l) 

8ort(l) 

8ortbib(l) 

comm(l) 

look(l) 


source.indent(l) 

source, mkstr .mkstr^l) 

source, binary, and/or manual for program.wherei8(l) 

source: read commands from file...C8h(l) 

space...mem(4S) 

space, closepl - graphics interface, /label.p!ot(3X) 

space on file systems.df(l) 

spaces, and vice versa.expand(l) 

spawn new process in a virtual memory efficient .... vfork(2) 

specified command.€sh(l) 

specified files. head{l) 

specified length.tnincate(2) 

specified time...a!arm(3C) 
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Permuted Indes 


ftlann - execute a sabroatine after a 
awapoa - 

epetl, 

spell, spellm, speliout - find 
spell, spellin, 


split - 
files, fsplit - 
frexp, Idexp, mod/ - 
nncleaa - nncp 
Ipq- 

Iprm - remove jobs from the line printer 
print/, /print/, 
exp, log, loglO, pow, 
log 10, pow, sqrt - exponential, logaritfim, power, 

rand, 

number generator; rontines for changing/ random, 

scan/, /scan/, 
Controller, 
id ~ Disk driver for Adaptec 
popd: pop shell directory 
pnshd: push shell directory 
sigstack - set and/or get signal 
imemtest - 
gxtest - 
diag - General-purpose 
stdio - 

htable - convert NIC 
tee - copy 

reset - reset the teletype bits to a sensible 
stty, gtty - set and get terminal 
fs 3 mc - synchronise a filers in-core 
if: conditional 
/stab - 

hashstat: print command hashing 
iostat - report I/O 
per/mon - graphical display of general system 
vmstat - report virtnal memory 
exit - terminate process with 
netstat - shew network 
ps - process 
stat, Istat, fstat - get file 
/error, feof, clearerr, fileno - stream 
mptime - show host 
rwhod - system 


wait, waits - wait for process to terminate or 

halt - 
pause - 
icheck - file system 
subroutines, dbminit, fetch, 
stHen, index, rindex - string operations, 
rindex - string operations, streat, stmeat, 
operations, streat, stmeat, stremp, straemp, 
/close, flush - close or flush a 
/open, /reopen, fdopen - open a 
/seek, /tell, rewind - reposition a 
fgetc, getw - get character or integer from 
gets, /gets - get a string from a 
putchar, fputc, putw - put character or word on a 
puts, /puts - put a string on a 
setbttffer, setlinebuf - assign buffering to a 
ungetc - push character back into input 

8 ^ - 

/error, feof, clearerr, fileno - 
rresvport, ruserok - routines for returning a 
rexec - return 
ar - Archive 1/4 inch 
gets, /gets - get a 
puts, /puts - put a 
bcopy, bemp, bxero, ffs - bit and byte 


specified time. 

specify additional device for paging and swapping, 
spell, spellin, speliout - find spelling errors. . . 

spellin, speliout - find spelling errors.. 

spelling errors.. 

speliout - find spelling errors. . • .. 

spline * interpolate smooth curve. 

split ~ split a file into pieces.. > 

split a file into pieces. 

split a multi-routine Fortran file into individual 

split into mantissa and exponent. 

spool directory clean-up. . • .. 

spool queue examination program. 

spooling queue. 

sprint/ - fomxatted output conversion. .... 
sqrt * exponential, logarithm, power, square root. 

square root, exp, log. 

srand - random number generator. 

srandom, initstate, setstate - better random • • 

sscan/ • /onrutted input conversion.. 

st - Driver /or Sysgen SC 4000 (Archive) Tape » 

ST-50fl Disk Controllers. 

stack.... 

stack... 

stack context. 

stand alone memory test. 

stand alone test /or the Sun video graphics board. 

stand-alone utility package. 

standard buffered input/output package. • • • 

standard format host tables. 

standard output to many files. •*••••«. 

stat, Istat, fstat - get file status. 

state. 

state. 

state with that on disk. 

statement. 

static in/onnation about the filesystems. . • . 

statistics.. . 

statistics... 

statistics... 

statistics. ..... • 

status. 

status. 

status..... 

status... 

status inquiries.. 

status of local machines. 

status server. 

stdio > standard buffered input/output package, 
sticky - executable files with persistent text. . . 

stop. 

stop: halt a job or procesf. 

stop the processor. . 

stop until signal... 

storage consistency check.• • • 

store, delete, firstkey, nextkey ~ data base • • . 
streat, stmeat, stremp, stmemp, strepy, stmepy, 
stremp, stmemp, strepy, stmepy, strlen, index, 
strepy, stmepy, strlen, index, rindex - string 

stream. 

stream.. 

stream... 

stream, getc, getchar, . 

stream. 

stream, putc, .. 

stream. 

stream, setbuf, .. 

stream... 

stream editor . 

stream status inquiries. 

stream to a remote command, remd,. 

stream to a remote command. 

Streaming Tape Drive. 

string from a stream. 

string on a stream. 

string operations.. 


alarm(dF) 

8wapon(8) 

spell(l) 

spell/l) 

spell(l) 

spell(l) 

8pline(lG) 

split(l) 

split(l) 

/split(l) 

/rexp(3) 

uuclean(8C) 

Iprm(l) 

print/(3S) 

exp(3M) 

exp(3M) 

rand(3C) 

random(3) 

scanf(3S) 

st(4S) 

sd(4S) 

csh(l) 

csh(l) 

sigstack(2) 

imemtest(88) 

gxte8t(8s) 

diag(8s) 

intr^3S) 

htable(8) 

tee(l) 

stat(2) 

re8et(l) 

stt3r(3C) 

/sync(2) 

c»h(l) 

/8tab(5) 

csh(l) 

io8tat(8) 

per/mon(l) 

vmstatfS) 

exit(3P) 

net8tat(8) 

p»(i) 

stat(2) 

/error(3S) 

ruptime(lC) 

rwhod(8C) 

intro(3S) 

8tickH8) 


wait(2) 

C8h(l) 

halt(8) 

pause(3C) 

icheck(8) 

dbm(3X) 

string(3) 

stringfSl 

string(3) 

/close{3S) 

/open(3S) 

/seek(3S) 

getc(3S) 

gct8(3S) 

putc(3S) 

put8(3S) 

8etb^(3S) 

ttngetc(3S) 

8ed(l) 

/erTor(SS) 

rcmd(3Ni 

rexec(3N) 

w(4S) 

gets(3S) 

put8(3S) 

b8tring(3) 
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Permuted Indes 


atrnempi strepy, 0 traq>y, Hriea, iadex, riadex - 
extract atringi from C programs to implement shared 

other binary, file, 
etrittgs. XBtr-extract 
stringf - find printable 

basename - 

streat, ttmeat, etremp, stmemp, strepy, etmepy, 
index, rindex - string operations, streat, 
string operations, streat, stmeat, stremp, 
streat, stiacat, stremp, stmemp, strepy. 


iaews - 
postnews - 
alarm - exeente a 
store, delete, firstkey, nextkey - data base 

su - 

secs - front end for the .SM SCCS 

snm - 
da - 
qnot - 

en- 
bw - 

colordemos - demonstrate 
eg- 

eons - driver for 
bsaaenbe - view S-D 
bdemos demonstrate 
moase - 

gxtest - stand alone test for the 

win - 

sin - is eanent maehine a 

santools - the 
sync - update the 
syne - update the 
update - periodically update the 
syne - update 
suspend: suspend a shell, resuming its 
intro - introduction to special files and hardware 

routing - system 
suspend: 
sleep - 
sleep - 
sleep - 


swab “ 
swapon - add a 
paging/swapping, 
swapping. 

swapon - add a swap device for interleaved paging/ 
swapon - specify additional device for paging and 

breaksw: exit from 
case: selector in 
default: catchall clause in 
endsw: terminate 

readlink - read value of a 
symiink - make 
strip - remove 

link, 


disk, fsync- 
select - 

esh - a shell (command interpreter) with C-like 

messages, perror, 
si - Driver for 


string operations, streat, stmeat, stremp, . • . 

strings, xstr -. 

strings - find printable strings in an object, or • 
strings from C programs to implement shared 
strings in an object, or other binary, file. . . . 
strip - remove S3rmbols and relocation bits. . . 

strip filename affixes. . 

strien, index, rindex - string operations. 

stmeat, stremp, stmemp, strepy, stmepy, strien, 
stmemp, strepy, stmepy, strien, index, rindex - 
atmepy, strien, index, rindex - string/ . . . . 

stty - set terminal options.. 

sUy, gtty - set and get terminal state. 

su - substitute user id temporarily. 

submit news articles. 

submit news articles. 

subroutine after a specified time. 

subroutines, dbminit, fetch, • .. 

substitute user id temporarily. 

subsystem. 

sum - sum and count blocks in a file.. 

sum and count blocks in a file. 

summarise disk usage. 

summarise file system ownership. 

sun - is current machine a sun workstation. • • 
Sun 5 Mb/s experimental Ethernet interface. • 

Sun black and white frame buffer. . 

Sun Color Graphics Display.. 

Sun color graphics interface.. 

Sun console... 

Sun logo.. 

Sun Monechrome Bitmap Display. 

Sun mouse.. 

Sun video graphics board. 

Sun window ^tem. 

sun workstation. 

santools - the Suntools window environment. 

Santools window environment. 

super block. 

super block. .. 

super block... 

super-block. .. 

superior. . 

support. 

supporting for local network packet routing. • • 

suspend a shell, resuming its superior. 

suspend execution for an interval. 

suspend execution for an interval. 

suspend execution for interval. 

suspend: suspend a shell, resuming its superior. 

swab - swap b 3 rtes. 

swap bytes. . • .. 

swap device for interleaved paging/swapping. • 
swapon - add a swap device for interleaved • • 
swapon - specify additional device for paging and 

swapping. 

swapping.. .. 

switch.. 

switch. 

switch. 

switch. 

switch: multi-way command branch. 

symbolic link. 

symbolic link to a file. 

symbols and relocation bits. 

symiink - make symbolic link to a file. 

symlnk - make a link to an existing file. • « • 

sync - update super-block. • * .. 

sync - update the super block. . .. 

sync - update the super block. 

synchronise a file's in-core state with that on 

synchronous I/O multiplexing. 

syntax. 

syscall - indirect system call. 

sys^errlist, sysjicnr, ermo - system error • . . 
Sysgen SC 4000 (Archive) Tape Controller. . . 


8tring(3) 

X8tr(l) 

8tring8(l) 

X8tr(l) 

string8(l) 

8trip(l) 

ba8ename(l) 

8tring(S) 

8tringf3) 

8tring(3) 

8tring(3) 

ettyfl) 

8tty(3C) 

,u(l) 

inews(l} 

po sinew 8(1) 

alarm(3F) 

dbm(3X) 

»n(l) 

SCC8(l) 

8um(l) 

sumfl) 

d«(i) 

quot(8} 

8un(l) 

en(4S) 


bw(4S) 

colordemo8(6) 

c^4S) 

con8(4S) 

bsuncube(6) 

bdemo8(6) 

mou8e(4S) 

gxte8t(88) 

win(4S) 

8un(l) 


suntoolsili 

8untool8(i) 

syncfl) 

sync(8) 

update{8) 

syttc(2) 

C8h(l) 

intro(4) 

routinf^4N) 

C8h(l) 

sleepfl) 

sleepISP) 

8leep(3) 

C8h(l) 

swab(3) 

8wab(3) 

8wapon(2) 

8wapoD(2)^ 

8wapon(8) 

8wapon(2) 

swapon(8) 

cshfl) 

C8h(l) 

cshfl) 

cshll) 

C8h(l) 

readlink(2) 

8ymlink(2) 

8trtp(l) 

symtink(2) 

link(3F) 

8yno(2) 

syncTl) 

synqS) 

f8ync(2) 

8elect(2) 

C8h(l) 

8y8call(2) 

perror(3) 

8t(4S) 
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Ptrmuiti InitM 


peiTor, 83ri.enrlis^, 
mil - 

Ceniroaics printer inteiface. Tpe - 
lioetid - print identifier of current fioet 
fioitnuae * vet or print name of current hovt 
mkfv - eonvtnict a file 
mkproto - construct a prototype file 
mount, amount« mount or remove file 
mount, umouat - mount and dismount file 
newfs - construct a new file 
savecere - save a core dump of the operatiuf 
setquota * enable/disable quotu on a file 
tip, cu * connect to a remote 
tuuefs - tune up an existing file 
usen • compact list of users who are on the 
vadrise - give advice to paging 
who - who is on the 
win - Sun window 
df - report free disk space on file 
syslog - log 

kgmon generate a dump of the operating 
rehash: recompute command hash 
unhash; discard command hash 
- keyboard translation table format and default 
mtab - mounted file system 
kbd * keyboard translation 
crontab - 

getdtablesiie - get descriptor 
htable - convert NIC standard format host 
route - manually manipulate the routing 
term - terminal driving 
term - terminal driving 
tbi - format 
gettable - get NIC format host 
expand, unexpand - expand 
ctags - create a 


talk - 

functions, sin, cos, 
sink, cosh, 
tar- 
tar- 

st - Driver for Sysgen SC 4000 (Archive) 
ar - Archive 1/4 inch Streaming 
tm - tapenuster 1/2 inch 
tp - DEC/mif 
mtio - UNIX magnetic 
tread, twrite, trewin, tskipf, tstate - f77 
mt - magnetic 
tm- 


deroff - remove nroff, troff, 
f77 tape I/O. topen. 


tektool - 
reset - reset the 
last - indicate last logins of users and 

Iseek, 

index, rindex, Inbink, len - 
operations, opendir, readdir, 

telnet - user interface to the 
telnetd - DARPA 

su --substitute user id 
tmpnam - create a name for a 


syslog - log systems messages. 

syslog - make sjrstem log entry.. 

syslog, openlog, closelog - control system log. • « • 
sysjserr, ermo - system error messages. 

sys^siglist - system signal messages. 

Systech MTI*800/1600 multi-tenninal interface. • • 
Systech VPC-2200 Venatec printer/plotter and • • 

system.. 

sjrstem. .... • 

system. .. » • • 

system. . 

system. .. 

system. .* » • 

system. • • • • .... 

system.... 

system. . 

system. ... 

system.. 

system .. • 

system. 

system. « • • • .. 

system. ..... • • • • 

systenas. .... 

systems messages.. 

system’s profile buffers. • * « .. 

table... 

table... 

table, kbd . 

table. 

table format and default table.. 

table of times to run periodic jobs. 

table vise. 

tables. 

tables.. 

tables for nroff. . 

tables for nroff. ... • • • • 

tables for nroff or troff. .. 

tables from a host.... • • 

tabs to spaces, and vice versa. . 

tags file.. • 

tail - display the last part of a file. 

talk - talk to another user. . 

talk to another user. « « • .. 

tan, asin, acoi, atan, atan2 - trigonometric • • • • 

tanh - hyperbolic functions. 

tape archive file format. 

tape archiver... 

Tape Controller. 

Tape Drive. .. 

tape drive. 

tape formats. • • . ... • « • 

tape interface. 

tape I/O. topen, tdose, .. 

tape manipulating program. 

tapemuter 1/2 inch tape drive. 

tar - tape archive file format. 

tar - tape archiver. • .. 

tbt • format tables for nroff or troff. . 

tbI and eqn constructs... 

tclose, tread, twrite, trewin, tskipf, tstate - • • « • 

tcp - Internet Transmission Control Protocol. , • • 

tee - copy standard output to many files. 

tektool - Tektronix 4014 terminal emulator tool. « • 

Tektronix 4014 terminal emulator tool. 

teletype bits to a sensible state. 

teletypes.. 

tell - move read/write pointer... , 

tell about character objects.. , 

telldir, seekdir, rewinddir, closedir - directory * • , 
telnet > user interface to the TEliNET protocol. • • 

TELNET protocol.. 

TELNEH* protocol server. .. , * 

telnetd - DARPA TELNET protocol server. . . • , 

temporarily.. 

temporary file. .... 

term - terminal driving tables for nroff.. 


syslogffi) 

syslonl) 

syslo^S) 

penor(S) 

p8ignal(3) 

mti(4S) 

vpc(4Sj 

hostid(l) 

hostname(l) 

mkf8(8) 

mkproto(8) 

mountf2j 

monnt(8) 

newfs(8) 

savecorrfS) 

setquota(2) 

tip(lC) 

innefs(8) 

U8erv(l) 

vadvisrf2) 

wMi) 

sysiog(8) 

kgmon(8) 

C8h(l) 

csh(l) 

kbd(5) 

mtab(5) 

kbd(5) 

crontab(5) 

getdtablesise(2) 

htable(8) 

route(8C) 

,term(5) 

tenii(5) 

tb!(l) 

gettable(8C) 

expand(l) 

ctag8(l) 

tail(l) 

talk(l) 

talk(l) 

sin(3M) 

sinh(SM) 

aa 

x\ 

tm(4S) 

ip(5) 

mtio(4) 

tepen(dF) 

mt(l) 

tm(4S) 

aa 

tbl(l) 

derofffl) 

topen($P) 

tcp(4P) 

te^l) 

tektooffl) 

tektool(l) 

reset(l) 

la8t(l) 

lseek(2) 

index(3F) 

directory(3) 

telnet(ic) 

telnet(lO) 

telnetd(8C) 

telnetd(8C) 

a«(l) 

tmpnam(3C) 

,term(5) 
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Permuted Indes 


term - ienninal drivins tables for nroff..tenn(6) 

termcap ~ terminal capability data base. ••••••. termcap(5) 

ttycame, isatty, ttyslot - find name of a termini... • , * ttyname(3) 

yhangap - virtnally **bangnp’’ the current control terminal. • • • ..▼hangup(2) 

worms - animate worms on a display terminal.worm8(6) 

termcap - terminal capability data base.termcap(5) 

tset - establish terminal characteristics for the environment.t8et(l) 

gettytab - terminal configuration data base.gettytab(5) 

pty - pseudo terminal driver... . • pty(4) 

term - terminal driving tables for nroff. .,term(5) 

term - terminal driving tables for nroff. » ..term(5) 

tektool - Tektronix 4014 terminal emulator tool.tektool(l) 

tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal independent operation routines, tgetent, • . « termca^SX) 

ttys - terminal initialisation data. • ..ttys(5) 

mti - Systech MTI-800/16(M) multi- terminal interface..mti(4S) 

tty - general terminal interface.fty(4) 

getty ~ set terminal mode. • • . ..getty(8) 

tty - get terminal name.) 

stty - set terminal options.0tt^l) 

ttynam, isatty - find name of a terminal port... • • ttynam(3F) 

clear - clear workstation or terminal screen.clear(l) 

script - make typescript of terminal session.script(l) 

stty, gtty • set and get terminal state.stt^SC) 

ttytype * data base of terminal types by port.ttytype(5) 

wait - wait for a process to terminate.wait(3F) 

_exit - terminate a process.exit(2) 

kill - send a signal to a process, or terminate a process. ..kilt(l) 

output, exit - terminate a process after flushing any pending.exit(d) 

abort - terminate abruptly with memory image.abort(3F) 

endif: terminate conditional. ..C8h(l) 

end: terminate loop.csh(l) 

wait, waits - wait for process to terminate or stop.wait(2) 

exit - terminate process with status.exit(3F) 

endsw: terminate switch.csh(l) 

imemtest * stand alone memory test.imemte8t(88) 

test - condition command.. te8t(l) 

isinf, isnan - test for indeterminate floating point values.i8inf(3) 

^test - stand alone test for the Sun video graphics board.gxte8t(88) 

quis - test your knowledge.quii(6) 

sticky - executable files with persistent text.sticky(8) 

ed - text editor. .ed(l) 

ex, edit - text editor. • . ..ex(l) 

more, page - browse through a text file.more(l) 

fmt-simple text formatter. . ..fmt(l) 

nroff text formatting and typesetting.nroff(l) 

ms - text formatting macros.m8(7) 

server, tftpd - DARPA Trivial File Transfer Protocol.tftpd(8C) 

terminal independent operation routines, tgetent, tgetnum, tgetflag, tgetstr, tpto, tputs.termcapfSX) 

independent operation routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal.termcap(3X) 

terminal independent operation routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - termcap(3X) 

operation routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs terminal independent .termcapf3X) 

routines, tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal independent operation .termcap(3X) 

fsync - synchronise a file’s in-core state with that on disk...f8ync(2) 

ccat - compress and uncompress files, and cat them, compact, uncompact,.compac^l) 

w - who is on and what they are doing.w(l) 

more, page ~ browse through a text file.more(l) 

alarm - schedule signal after specified time.alarmfSC) 

alarm execute a subroutine after a specified time....alarm(3F) 

at ~ execute commands at a later time.at(l) 

gettimeofday, settimeofday - get/set date and time.... ..gettimeofday(2) 

shutdown - close down the system at a given time.8hutdown(8) 

time, ftime - get date and time.time(3C) 

time - time a command.timef 1) 

time - time a command.time(l) 

getdate - convert time and date from ASCII.getdate(3) 

time; time command.C8h(l) 

time, ftime - get date and time.time(3C) 

idate, itime - return date or time in numerical form.idate(3F) 

profil - execution time profile.profil(2) 

timed ~ DARPA Time server.timed(8C) 

time: time command.csh(l) 

asctime, timesone, dysise - convert date and time to ASCII, ctime, local time, gmtime, •..•••• ctime(3) 

timed *- DARPA Time server.. . , timed(8C) 

getitimer, setitimer - get/set value of interval timer.getitimei(2) 

times ~ get process times.time8(3C) 

utime - set file times. • . ..utime(3C) 
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PttmuUd Inits 


Qtimefl - set file 

cronUb - t&ble of 
/export, login, newgrp. rend, readonly, set, shift, 
ASCII, ctime, localtime, gmtime, asctime, 


/iscntrl, isaacii, isgraph, tonpper, tolower, 
/if print, iacntrl, isaacii, iagraph, tonpper, 
tektool - Tektronix AOXi terminal emnlator 
tatate - f77 tape I/O. 

tfort - 

iapnnct, iiprint, iacntrf, iaaacii, iagraph, 

tgetcnt. tgetnnm, tgetflag, tgetatr, tgoto, 

ptraee - proceaa 
trpt - tranaliterite protocol 
goto: command 
ftp - ite 

ftpd - DARPA Internet Pile 
tftpd - DARPA Trivial File 
tr- 

kbd - keyboard 
pi - Paacal interpreter code 
trpt - 
tcp - Internet 
- encode/decode a binary file for 
trpfpe, fpecnt <- 
login, newgrp, read, readonly, set, shift, times, 
I/O. topen, tclose, 

trek - 

topen, tdoae, tread, twrite, 
ain, cot, tan, aata, acot, atan, atan2 - 
tftpd - DARPA 
tbi - format tables for nroff or 

checknr - check nroff/ 
deroff - remove nroff, 
faults. 

false, 

tmncate, ftmncate - 
specified length, 
false, tme - provide 
true, false * provide 
chue - 
environment, 
topen, tclose, tread, twrite, trewin, 

topen, tclose, tread, twrite, trewin, tskipf, 


terminal. 

ttyname, isatty, 

tnnefs - 

topen, tclose, tread, 
file - determine file 
types - primitive system data 

ttytype - data base of terminal 
script - make 
man - ixucros to 
eqn, neqn, checkeq - 
troff - 

nroff •> text fonnatting and 
getpw - get name from 


times... 

times - get process times. .. 

times to inn periodic jobs. 

times, trap, nmask, wait - command langnage. 

timesone, dysise ~ convert date and time to. 

tip, cn ~ connect to a remote system. 

tm - tapemaster 1/2 inch tape drive. 

tmpnam - create a name for a temporary file. « * • « • 
toascii - character dassification and conversion/ * • • • 
tolower, toascii - character dassification and/ • . • • • 

tool.. .. 

topen, tdose, tread, twrite, trewin, tskipf. 

topological sort. 

touch - update date last modified of a file. 

tonpper, tolower, toasdi - character/ /isspace. 

tp - DEC/mag tape formats. 

tpnts - terminal independent operation routines. 

tr - translate characters.. • • • 

trace. • ... 

trace. 

transfer. • • • • .. 

transfer program. 

Transfer Protocol server. . 

Transfer Protocol server. 

translate characters.. 

translation table format and default table. 

translator.. 

transliterate protocol trace. 

Transmission Control Protocol... 

transmission via mail, uuencode.uudecode. 

trap and repair floating point faults. ••*•••••• 

trap, umuk, wait - command language, /export, • • • 

tread, twrite, trewin, tskipf, tstate - f77 tape . 

trek - trekkie game. 

trekkie game. 

trewin, tskipf, tstate - tJ7 tape I/O. « .. 

trigonometric functions. 

Trivial File Transfer Protocol server. . 

troff. . 

troff - typeset or format documents. 

troff files. 

troff, tbI and eqn constructs. 

trpfpe, fpecnt - trap and repair ffoating point . 

trpt - transliterate protocol trace. .. • • , • 

true - provide truth values. 

true, fdM - provide truth vdues. 

truncate a file to a spedfied length. • .. 

truncate, ftruncate - truncate a file to a. 

truth values. 

truth values. 

Try to escape to killer robots. 

tset establish terminal characteristics for the. 

tskipf, tstate - f77 tape I/O. 

tsert - topological sort. 

tstate - n7 tape I/O.. 

tty general terminal interface. . 

tty - get terminal name. 

ttynam, isatty - find name of a terminal port. 

ttyname, isatty, ttyslot - find name of a . 

ttys - terminal initialisation data. • .. 

ttyslot - find name of a terminal. ... « • • 

ttjrtype - data base of terminal types by port. 

tune up an existing file system. 

tunefs - tune up an existing file ssrstem... 

twrite, trewin. tskipf, tstate - f77 tape I/O. . 

type. . 

. 

types - primitive ssrstem data types.. . 

types by port. 

typescript of terminal session.. • • « 

typeset manual.. 

typeset mathematics. 

t 3 rpe 8 et or format documents. , ... • • 

typesetting. • . . , .. 

udp - Internet User Datagram Protocol. 

uid.. . . ... .. 


ntimes(2) 

times(dC) 

crontab(5) 

ah(l) 

ctime(3) 

tipflC) 

tm(4S) 

tmpnam(3C) 

ctjpefa) 

ctype(3) 

tektool(l) 

topen(3P) 

t8ort(l) 

touch(l) 

ctype(3) 

tp{6) 

termcap(SX) 

ti(i) 

pti»ce(2) 

tipt(8C) 

c»k(l) 

ftp(ic) 

ft|)<l(8C) 

tftpd(8C) 

ti(l) 

kM(6) 

P'U) 

tipt(8C) 

tep(4P) 

unencodeflC) 

tipfpe(3F) 

ak(l)^ 

topea(3F) 

trek(O) 

trek(6) 

topen(3F) 

sin(3M) 

tftpd(8C) 

tbl(l) 

trDff(l) 

checknr(l) 

derofl(l) 

trpfp^SF) 

trpt(8C) 

false(l) 

true(l) 

truncatef2) 

tnincate(2) 

false(l) 

tme(l) 

iS’ 

topen(3F) 

tsort(l) 

topen(3F) 

ttynam(3F) 

ttynam^S) 

ttys(S) 

ttyname(3) 

ttytype(5) 

tunef8(8) 

tnnef8(8) 

topen(3F) 

Ml) 

typeats) 


MytyM*) 

acript(l) 

inui(7) 

eqB(l) 

troi^l) 

nroffi[l) 

mdp(4P) 

Ketpw(S) 
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Permuted Index 


ftew^rp, re&d, reulonly, set, shift, times, trap, 

mount, 

mount, 

and cat them, compact, 
compact, uncompact, ccat -- compress and 

ul - do 
ungct - 
expand, 


mktemp - make a 
gethostid - get 
flush - flush output to a logical 
fseek, ftell - reposition a file on a logical 
gete, fgetc - get a character from a logical 
fpute - ^rite a character to a FORTRAN logical 
getfd - get the file descriptor of an external 

reboot - 
system - execute a 
uux - Unix to 
UUCP, uulog - Unix to 
mtio - 
analyse - Virtual 
uux - 
UUCP, uulog - 


rmdir, rm - remove ( 
rm, mdir - remove ( 
munmap - 
recnews - receive 
recnews *- receive 


uptime - show how long system has been 
unclean - uucp spool directory clean- 
tnnefs - tune 

touch - 
sync- 
sync - 
sync - 

update * periodically 

du - summarise disk 
miscellaneous - miscellaneous 
news - 

checkaews - check if user has news on the 
login: login new 
talk ^ t^k to another 
write * write to another 
seteuid, setruid, setgid, setegid, setigid - set 
udp - Internet 
environ - 
checknews - check if 
su - substitute 
getuid, geteuid - get 
setreuid - set real and effective 
telnet - 
ulimit - get and set 
getuid, getgid - get 
sail o multi- 
whoamt - display effective current 
adduser - procedure for adding new 
/bin/mail - send or receive mail among 
wall - write to all 
system. 


ul - do underlining. 

ulimit - get and set user limits. 

umask - set file creation mode mask. • • • • . 
umask: change or display file creation mask. • . 
umask, wait - command language, /export, login, 
umount - mount and dismount file system. . . 

umount - mount or remove file system. 

unalias: remove aliases. 

uncompact, ccat - compress and uncompress files, 

uncompress files, and at them. 

underlining. 

undo a previous get of an SCC3 file. 

unexpand - expand tabs to spaces, and vice versa, 
unget - undo a previous get of an SCCS file. . . 
ungetc - push character back into input stram. 

unhash: discard command hash table. 

uniq - report repated lines in a file. 

unique file name. 

unique identifier of current host. 

unit... 

unit.. 

unit.. 

unit, putc, . 

unit number. . 

units - conversion program. 

UNIX bootstrapping procedures. 

UNIX command. . 

Unix command execution. 

Unix copy. 

UNIX magnetic tape interface. 

UNIX postmortem crash analyser. . 

Unix to Unix command execution. 

Unix to Unix copy. 

unlimit: remove resource limitiations. 

unlink - remove a directory entry. 

unlink - remove directory entry. 

unlink) directories or files. 

unlink) files or directories. 

unmap pages of memory. 

unprocessed articles via mail. 

unprocessed articles via mail. 

unset: discard shell variables. 

uasetenv: remove environment variables. • « • 

«P. 

«P • . . .. 

up an existing file system. 

update - periodically update the super block. 

update date last modified of a file. 

update 8uper*block. 

update the super block. 

update the super block. 

update the super block. 

uptime - show how long system has been up. 

usage. 

useful information pages.. . « . 

USENET network news article, utility files. « . 

USENET news network. 

user. . 

user . 

user . 

user and group ID. setuid. 

User Datagram Protocol.. 

user environment. 

user has news on the USENET news network. 

user id temporarily. 

user identity. 

user id’s.. 

user interface to the TELNET protocol. ... * 

user limits.* . • • . 

user or group ID of the caller. 

user wooden ships and iron men. 

username. . .. 

usen. ... 

users. 

users... 

users - compact list of users who are on the • • 


... «i(i) 

« . . ulimit(3C) 

. • . uma8k(2) 

. . . csh(l) 

. . . sh(l) 

• « . mount(8) 

« • . mount(2) 

• . • C8h(l) 

. • • compactfll 
. • • compact(l) 

. . . ul(l) 

• * • unget(l) 

• . • expands) 

. . « nnget(l) 

• * • ungetc(3S) 

. . . C8h(l) 

. . . uniq(l) 

. . . mktemp(3) 

. . . getho8tid(2) 

. . . flu8h(3F) 

. . . f8cck(3F) 

. . . gctc(3F) 

. . . putc(3F) 

. . . gctfd(3F) 

• . • unit8(l) 

. . . reboot(8) 

. . . 8ystem(3F) 

• . • uux(lC) 

. • • uuc^lC) 

• . • mtio(4) 

. . . analyses) 

« « • uux(lC) 

. • • uucp(lC) 

• • . C8h(l) 

• « . unlink(3F) 

• . . unlink(2) 

« « • rmdir(l) 

• . • rm(l) 

. . « munmap(2) 

« . . recnew8(l) 

. . . recnew8(8) 

• • « cshfl) 

« . • C8h(l) 

. • • uptime(l) 

• • . uucleanfSC) 

. • . tunef8(8) 

• , • update(8) 

. « . touch(l) 

. . , 8ync(2) 

. . . syncCl) 

. . . 8ync(8) 

• . . npdate(8) 

. . . uptime(i) 

. . . du(l) 

. . * introf?) 

. • . new8(5) 

. . . checknew8(l) 

. . . C8h(l) 

. . . talk(l) 

• , • write(l) 

• . . 8etuid(3) 

. . . udp(4P) 

, . . environ(5) 

. . . checknew8(l) 

• . . 8u(l) 

. • . getuid(2) 

. , . 8etreuid(2) 

. . • telnet(lC) 

. . . ulimit(3C) 

. . • getuid(3F) 

. • • 8ail(6) 

. . . whoami(l) 

• • • addu8er(8) 

. • . binmail(l) 

. . , wall(l) 

• . . nseis(l) 
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Ptrmuiti Indes 


IjmI - indicUe lut lofins of 
goilof - cel 
nsen - compnd list of 
vi ~ Tiew 4 file withoni cbnncinc it 
news - USENEn* network news article, 
ding - Genenl-pnrpose stand-alone 
getmiaf e - get information about resonrce 
▼times * get information about resource 


rmail - handle remote mail received via 
uudean - 

transmission via mail nuencode, 

uuencode - format of an encoded 
for transmission via mail 

UUCP, 


▼al- 

abs - integer absolute 
fabs, floor, ceil ~ absolute 
getenv - 
readlink - read 
getenv - get 
getitimer, setitimer - get/set 
set: change 
false, true - provide truth 
isnam - test for indeterminate floating point 
flmax, dflmin, dflmax, inmix • return extreme 
true, false - provide truth 
htoni, htons, ntohl, ntohs - convert 

set: change value of shell 
▼arargs - 
setenv: set 
O: arithmetic on shell 
unset: discard shell 
unsetenv: remove environment 
getenv get value of environment 
▼ax - is current machine a 

assert - program 
lint - a C program 
expand, uncxpand - expand tabs to spaces, and vice 
vp - Ikon 10071-6 Multibus 
interface, vpc -< Sjrstech VPC-2200 
get - get a 
what - identify the 
hangman - Computer 
Kcsdiff * compare two 

efficient way. 

terminal, 
on ex. 
visual editor. 

▼i - view a file without changing it using the 
recnews - receive unprocessed articles 
recnews - receive unprocessed articles 
sendnews - send news articles 
- encode/decode a binary file for transmission 
uurec - receive processed news articles 
rmail - handle remote mail received 
expand, nnexpand - expand tabs to spaces, and 
gxtest - stand alone test for the Sun 
bsuncube - 
editor, vi - 


users and teletypes. 

user’s login name. 

users who are on the system. . 

using the vi visual editor. . 

utility files. 

utility package. ... 

utilisation. .. 

utilisation... 

utime - set file times. 

utimes - set file times. • • .. 

utmp, vtmp - login records. 

unclean - uucp spool directory dean-up. 

UUCP. 

uucp spool directory dean-up. 

UUCP, uulog - Unix to unix copy.. • • • • 

uudecode - encode/decode a binary file for •••••• 

uuencode - format of an encoded uuencode file. • . • • 

uuencode file. . 

uuencode,uudecode - encode/decode a binary file • • « • 

uulog - Unix to Unix copy. .. 

uurec - receive processed news artides via mail. 

uusend - send a file to a remote host. 

uux - Unix to Unix command execution. 

▼advise - give advice to paging system. «••••••• 

vatvalidate sees file... • • • 

validate seeS file. 

▼alloc - aligned memory allocator. . 

value.. 

value, floor, ceiling functions. 

value for environment name.. 

value of a sjmbolic link.. • 

value of environment variables.. • • 

value of interval timer. .. 

value of shell variable. .'. 

values. • • • • ... 

values, isinf. 

values, flmin, ... 

values.. 

values between host and network byte order. . 

▼arargs * variable argument list. 

variable..* .. 

variable argument list. 

variable in environment. 

variables.. « • . ... • • 

variables.. • « * • 

variables. * * ... 

variables.. 

▼ax. . • . • ... • • • 

vax * is current machine a vax.. 

verification. .. 

verifier... 

versa..... 

Versatec parallel printer interface. 

Versatec printer/plotter and Centronics prints * • « • 

version of an SCCS file... 

▼enion of files. 

version of the game hangman.. 

venions of an SCCS file.. 

▼font - font formats. .. 

▼fork - spawn new process in a virtual memory • • • « 

▼grind - grind nice listings of programs.. • • 

▼hangup - ▼irtually ^’hangup” the current control • . • 

▼i - screen oriented (visual) display editor based * • • • 

▼i - view a file without changing it using the vi • • • • 

vi visual editor.*.. 

via mail.. 

via mail.... 

via mail. 

via mail. uuencode,unde€ode .. * 

via mail. 

via uucp. .. 

vice versa.. 

video graphics board. .. 

view $-D Sun logo. ... 

view a file without changing it using the vi visual . . . 
▼ipw ~ edit the password file. 


last(l) 
gctlo^SF) 
U8erv(l) 
▼iew(I) 
new8(5) 
diag(88) 
getrusage(2) 
▼time8(3C) 
utime(SC) 
utimes(2) 
utmp(5) 
uuclean(8C) 
niiail(8) 
uuclean(SC) 
uucp(lC) 
uuencode' 
uuencode 
uuencode 
uuencode 
uucp(lC) 
uurec(8) 
uusendflC) 
uux(lC) 
▼advise(2) 

:S!l! 

▼allots) 

»b»(9) 

fiooi(3M) 

getenv(3) 

readlink(2) 

getenv(3P) 

gctitimet(2) 

csh(l) 

false(l) 

isinf(3) 

range(3F) 

tfue(l) 

byteorder(3N) 

vararg8(3) 

ah(l) 

eshm 

€Sh(l) 

csh(t) 

getenv(3F) 

d!i 

asseri(3) 

expaBd(l) 

▼p(es) 

▼pc(4S) 

get(l) 

what(l) 

hangun(6) 

sccsdiff(l) 

▼font(5) 

▼fork(2l 

vgrind(i) 

▼haagup(2) 

tI(1) 

'^11! 


recnewafl) 

recnewB(8) 

sendnew8(8) 

uuencode(lC) 

uurec(8) 

rmail(8) 

cxpand(l) 

gxteBt(88) 

bsunenb^fi) 

▼iew(l) 

▼ipw(8) 
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Permuted Indes 


vfork - sp&wa new process in n virtual memory efficient way. . ..vfork(2) 

vmstat ~ report virtual memory statistics. ..vmstat(8) 

analyze - Virtual UNIX postmortem crash analyzer..analyzc(8) 

vhangup - virtually ‘^hangup” the current control terminal.vhangup(2) 

vi - screes oriented ( visual) display editor based on ex.vi(l) 

vi - view a £le without changing it using the vi visual editor.view(l) 

consumption, vlimit - control maximum system resource .vlimit(3C) 

vmstat - report virtual memory statistics.vmstat(8) 

fs, inode - format of file system volume. . . • ..fs(5) 

printer interface, vp - Ikon 10071-6 Multibus Versatec parallel . . . • • vp(4S) 
and Centronica printer interface, vpc - Systech VPC-2200 Versatec printer/plotter • • • . vpeUS) 

printer interface, vpc - Systech VPC-2200 Versatec printer/plotter and Centronics . . . vpc(4S) 

vs wap - convert a foreign font file.vswap(l) 

utilization, vtimes - get information about resource.vtime8(3C) 

w - who is on and what they are doing.. • w(l) 

wait - await completion of process.wait(l) 

read, readonly, set, shift, times, trap, umask, wait - command language, /export, login, newgrp, . « • 8h(l) 

wait - wait for a process to terminate.wait(3P) 

wait ~ wait for a process to terminate.wait(3P) 

wait: wait for background processes to complete.C8h(l) 

sigpause - atomically release blocked signals and wait for interrupt.8igpau8e(2) 

wait, waits - wait for process to terminate or stop.wait(2) 

wait: wait for background process^ to complete.csh(l) 

stop, wait, waits - wait for process to terminate or .wait(2) 

wait, waits wait for process to terminate or stop.wait(2) 

psrmail - print out waiting mail. . ..prmail(l) 

wall write to alt users.wall(l) 

- spawn new process in a virtual memory efficient way. vfork .vfork(2) 

wc - word count.wc(l) 

what - identify the version of files.what(l) 

whatis - describe what a command is...whati8(l) 

crash - what happens when the system crashes.crash(88) 

w - who is on and what they are doing...w(l) 

whatis - describe what a command is.whatis(l) 

crash -* what happens when the system crashes.crash(8s) 

leave - remind you when you have to leave.leave(l) 

program, whereis - locate source, binary, and/or manual for • • . wherei^l) 

and paths (esh only), which locate a program file including aliases .which(l) 

export, login, newgrp, read,/ sh, for, case, if, while, break, continue, cd, eval, exec, exit, .6h(l) 

while: repeat commands conditionally.csh(l) 

break: exit while/foreach loop.C8h(l) 

bw Sun black and white frame buffer.bw(4S) 

who - who is on the system.who(l) 

users - compact list of users who are on the system. « • ..U8eis(l) 

from - who is my mail fromt.from(l) 

w " who is on and what they are doing.w(l) 

who - who is on the system...wh<^l) 

whoami - display effective current username.whoami(l) 

rwho - who’s logged in on local machines.rwho(lC) 

fold - fold long lines for finite width output device.fold(l) 

win - Sun window system.win(4S) 

lockscreen - maintain window context until ’’login”.lock8creen(l) 

screens, adjacentscreens - notify the window driver of the physical relationships of .adjacent8creen8(l) 

suntools -> the Suntools window environment.8untool8(l) 

win ~ Suit window system...win(4S) 

vi - view a file without changing it using the vi visual editor. .view(l) 

fastboot, fasthalt - reboot/halt the system without checking the disks.fa8tboot(8) 

sail - multi-user wooden ships and iron men.8ail(6) 

wc- word count. ....v<^l) 

putc, putchar, fputc, putw - put character or word on a stream.putc(3S) 

cd - change working directory.cd(l) 

chdir -change current working directory.. chdir(2) 

getewd - get pathname of current working directory.getcwd(3P) 

pwd - print working directory name.pwd(l) 

getwd - get current working directory pathname.getwd(3) 

sun - is current machine a sun workstation.. 6nn(l) 

clear - clear workstation or terminal screen.clear(l) 

worm - Play the growing worm game.worm(6) 

worm - Play the growing worm game. . . ..worm(6) 

worms - animate worms on a display terminal.worm8(6) 

worms - animate worms on a display terminal.worm8(6) 

write - write to another user. .write(l) 

putc, fputc - write a character to a FORTRAN logical unit.putc(3F) 

write, writev - write on a file.write(2) 

iseek, tell - move read/ write pointer.l8eek(2) 

wall - write to all users. • ..wall(l) 
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Permuted Indei 


write - write to inother vser. 

write, writer - write on n file. 

write, writer - write on n file. • • • .. 

open - open n file for rending or writing, or crente n new file. 

ntmp, wtmp - login records. • .. 

wnmp - the gnme of hnnt-tbe-wnmpns. . • « 

wnmp - tlie game of finnt4he- wnmpns. 

xsend, xget, enroll - secret mail. 

xsend, xget, enroll -> secret mail. 

implement shared ftrin 0 . xstr - extract strings from C programs to • » 
Controllers, xy - Disk driver for Xylogics SMD Disk • • • 

xy - Disk driver for Xylogics SMD Disk Controllen. 

j0» jl, in, yO, yl, yn - bessel functions. 

jO, jl, jn, yO, yl, yn - bessel functions. . 

yacc - yet another compiler-compiler. • * * • 
eyacc - modified yacc allowing much improved error recovery. 

yes - be repetitively affirmative. 

jo, jl, jn, yO, yl, 3 m - bessel functions. 

leave - remind you when you have to leave. • • . • .. 

leave - remind you when you have to leave. 

ts - silog 85S0 see serial comunications driver. 

ss • filog 8530 see serial comunications driver. 


writefl) 

write(2l 

write(2) 

open(2) 

utmi^S) 

wumiKfi) 

wump(6) 

xsendll) 

X8ettd(l) 

xy(4S) 

xy(4S) 

jO(3M) 

jO(3M) 

y»cc(l) 

«yxec(l) 

jre8(l) 

jO(3M) 


leavefl) 

leave(l) 

I8(4S) 

I8(4S) 
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INTRODUCTION TO THE SUN UNIX SYSTEM 

MANUALS 


These manuals describe the features of the UNKf system for the Sun Workstation, and provide 
tutorial information about the UNIX operating system, its facilities, and its implementation. 

There are three major groups of manuals. The first group consists of three manuals which are 
essentially reference manuals for, respectively, the user, programmer, and system administrator 
of the Son UNIX System. These manuals are extensively reworked, revised, reorganized deriva¬ 
tions of the original UNIX Programmer’* Manual', we place them in a unique category because 
of certain formatting and organizational conventions which have survived their revision. These 
conventions are explained below. The second group is a new set of reference manuals treating 
functional areas of the Sun UNIX operating system — windows, system internals, and so on. 
The fineil group is an set of manuals which contain tutorial-style papers on various aspects of 
the system; there is a manual on text editing and documentation, one on C programming, one 
which introduces UNIX to the first-time user, and so on. In the following, we discuss each group 
of manuals in more detail. 

1. Manuals Derived from the Old UNIX Programmer’s Manual 

The material in the three Sun reference manuals was originally bound together in a single 
volume known as the UNIX Programmer’* Manual. We have unbundled the material into more 
focused and manageable guides; however, we have maintmned the section numbering from the 
original manual (so that users familiar with it won’t be at sea with the new documentation). 
We hope that new UNIX users will forgive the rather strange numbering scheme that resulted 
from this compromise, and that older ones will not grumble too much at the demise of the 
Programmer’* Manual. The three new manuals are as follows: 

1.1. User’s Manual 

documents the facilities available to a Sun Workstation user (Section 1). The manual also 
includes a section on games (Section 6), and a section with tables of information about character 
codes, macro packages for typesetting, and so on (Section 7). 

' Commands generally reside in the /bin directory (for binary programs). Some commands also 
reside in / u*r/ bin, or in / u*r/ ucb, to save space in /bin. The command interpreters (known as 
the *hellt) search these directories automatically. 


t UNIX is a trademark of Bell Laboratories. 
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1.2. System Interface Manual 

covers areas of interest to programmers. It contains sections on system calls (Section 2), library 
functions (Section 3), devices and special files (Section 4), and file formats (Section 5). It also 
includes the System Interfere Overview, a document which summarizes the facilities — basic 
kernel functions and standard system abstractions for files and file systems, communications, 
process control and debugging — provided by the 1.0 version of the Sun UNIX operating sys* 
tern. Finally, a Tutorials section contmns a paper on the Interprocess Communication facilities 
included in the Sun UNIX operating system. 

System calls are entries into the UNIX system supervisor. The system call interface is identical 
to a C language procedure call; the equivalent C procedures axe described in Section 2. Assorted 
subroutines are available; they are described in Section 3. The primary libraries in which they 
are kept are described in intro(3). The functions are described in terms of O, but most work 
with FORTRAN as well. The special files section (4) discusses the characteristics of each qrstem 
‘file’ that actually refers to an I/O device. The names in tins section refer to the UNIX system 
device names for the ha^ware, instead of the names of the special files themselves. The file foi^ 
mats and conventions section (S) documents the structure of particular kinds of files; for 
instance, the form of the output of the loader and assembler b given. Files used by only one 
command are not documented; the assembler’s intermediate files, for example, are excluded. 


1.3. System Manager's Manual for the Sun Workstation 

contains information needed to install and configure the Model lOOU, 150U, and 120 Sun 
Workstations, install the UNIX system, and run the UNIX system on a day*to>dsy basb. The 
System Manager’s Manual includes a detmled guide to system set>up and operation: System 
Installation and Maintenance Guide, maintenance commands and procedures (Section 8), and 
tutorials on subjects such as sendmail and uucp installation. 

The maintenance section discusses commands and procedures used by the ^stem manager (who 
is also called the super-user). Most commands and files described are kept in the /etc directory. 
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Each section of the reference manuals consists of a number of independent entries of a page or 
so each. The name of the entry is in the upper corners of its pages, follo'wed by the section 
number, and sometimes a letter characteristic of a subcategory; for instance, graphics is IG, and 
the math library is 3M. Entries within each section are in alphabetical order. At the bottom 
left of each page is the release level of the Sun system, and the date in the middle of the page 
reSects the date on which the manual page was changed for any reason. 

All manual entries have a common format, though for any given entry only relevant subsections 

appear: 


Contains 


NAME The name subsection lists the exact names of the commands and subroutines 

covered under the entry and gives a very short description of their purpose. 

SYNOPSIS Summarizes the use of the program. A few conventions are used, particularly 
when commands are being described: * 

Boldface words or letters are literals; type them just as they appear. 

Square brackets *[ ]’ around an argument indicate that the argument is optional. 
When an argument is given as ‘name’ or ‘file’, it always refers to a file name. 

Braces }’ around an argument indicate that the argument is mandatory. 

Ellipses are used to show that the previous argument-prototype may be 
repeated. 

DESCRIPTION Discusses what the utility does for you. 

OPTIONS Lists the options which apply to the command. 

EXAMPLES Illustrates typical use of the command. 



FILES 


Lists the names of files which the program uses in the course of its job. 


SEE ALSO 


Indicates related information — such as other manual entries to read. 


DIAGNOSTICS Deals mainly with the exit codet returned to the shell by exiting commands. Exit 
codes can be used in shell scripts to control the actions of the shell. 


BUGS 


Documents known problems with the command, sometimes discusses deficiencies, 
and occasionally describes suggested fixes. 
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3. New Sun Reference Manuals 

There are some original reference manuals written for specific Sun products. These additional 
manuals are described in the sections below. 

3.1. Suncore Programmer’s Reference Manual 

Reference material for the SunCore Graphics package. In addition to a formal description of all 
SunCore library calls, there are also descriptions of the Son device support, and descriptions of 
the interfaces to the SunCore library via FORTRAN and Pascal. 

3.2. Programmer’s Reference Manual for Sun Windows 

Reference and tutorial material for programming applications using the SonAA^ndows facilities. 

3.3. System Internals Manual 

The System Internals Manual discusses several aspects of the implementation of the Sun UNIX 
System. Contents are: 

Networking Implementation Notes 

Describes the internal structure of the networking facilities of the Sun UNIX operating sys¬ 
tem. 

Changes to the Kernel 

Summarizes the changes to the kernel made between the last and the current release. 
Treats broad, organizational changes and consequences for individual files. 

Device Driver Reference Manual for the Sun Workstation UNIX System 

A guide to writing your own device driver. Describes how to rebuild the UNIX system ker¬ 
nel and add software drivers for new devices to the kernel, provides sample drivers, and 
summarizes functions and interfaces between the driver and the kernel. 

Using ADD to Debug the UNIX Kernel 

Describes extensions made to the 0.4 release of the Sun UNIX system debugger, adb, to 
allow standard adb commands to function properly with the kernel, and introduces the 
basics of writing adb command scripts. 

A Fast File System for UNIX 

Describes the reimplementation of the UNIX file system. 

The CPU PROM Monitor 

Information on the PROM Monitor functions, commands, messages, and keyboard control 
codes. 
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4. Supplementary Manuals 

In addition to the manuals derived from the old UNIX Programmer’s Reference Manual, there 
are a number of other manuals ranging in level from basic ‘getting started’ to technical papers 
derived from Bell Labs or Berkele publications. These additional manuals are described in the 
sections below. 


4.1. Beginner’s Guide to the Sun Workstation 

A general overview and introduction to UNIX. The manual provides roadmaps and guides to 
the rest of the documentation, plus some tutorial introductions to the Sun system. It also con¬ 
tains a general guide to the communication facilities that UNIX offers you. First-time users are 
advised to start here. The contents are: 

Getting Started 

An introduction to the most basic use of the Sun UNIX system. Includes discussions of how 
to log in, UNIX file and directory structure, basic commands, and how to log out. 

Working with Files 

Describes various commands and utilities for file manipulation — more, head, tail, grep, 
pattern matching utilities, sort, diff, and so on. 

Using the Shell 

How to use the facilities of the shell to make your work easier. Covers redirection of input 
and output, pipes, job control, and the history and alias facilities. 

Creating and Editing Text Files — The vi Editor 
An introduction to the visual editor. 

Printing and Formatting Documents 

How to display and print files, and how to ‘turn them into’ documents. This chapter covers 
nr off and troff, the formatting macro package ms, and the more specialised document for¬ 
matting preprocessors, tbl and eqn . 

Communications 

Introduces basic UNIX communications facilities: how to use the mail system, how to write 
to other users logged in to the same system, how to use network facilities, tip and UUCP. 
Using the C Shell. 

Introducing a popular command interpreter, the C Shell, and many of the commonly used 
UNIX commands. 

Using the Bourne Shell 

The Bourne Shell is the Version 7 UNIX Shell and is heavily used in system command 
scripts. 

Mail User’s Guide 

Complete details on the electronic mail facilities. Includes a quick-reference sheet. 

Network News User’s Guide 

Describes what the network news is, how to join news groups, how to read news, and how 
to post your own news. Includes a quick-reference sheet. 

4.2. Editing and Text Processing 

Documents the facilities that UNIX offers for massaging text files in various ways, and for pro¬ 
cessing documentation. Part One of the manual provides information on the text editors and 
Part Two describes the document formatting tools. Contents: 
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An Introduction to Text Editing 

Describes the basics of text editing and provides a guide to the avmlable editing tools. 
Newcomers should start here. 

Uaing the ‘vi Visual Displag Editor 

Tutorial and reference information on the vt editor. Includes a quick reference sheet. 
Command Reference for the ‘ex’ Line Editor 

A command reference for the ex and vi editors. Also includes a quick reference sheet. 

Using the ‘ed’Line Editor 

Provides a user’s guide to the original UNIX editor. 

Using ‘sed’, the Stream Text Editor 

A variant of ed for processing large files. 

Pattern Scanning and Processing with A WK 

Makes it easy to specify many data transformation and selection operations. 

An Introduction to Text Processing 

Introduces the basics of text processing, macros and macro packages. Includes explanations 
of the tools and examples of usage. 

Formatting Documents with the -ms Macro Package 

Describes -ms, a standardized package of formatting requests that can be used to lay out 
most documents. Includes a quick-reference summary of requests. 

Formatting Documents with nroff and troff 

Introduces the basic document layout facilities. Includes both a user’s gmde and reference 
material. 

Formatting tables with thl 

Describes tbl, an easy-to-learn notation for specifying tabular layout for typesetting. 
Typesetting Mathematics with eqn 

Describes eqn, another easy-to-leam language for doing high-quality mathematical typeset¬ 
ting. 

Formatting Documents with the -me Macro Package 

A popular macro package for nroff. Includes a user’s guide, reference material, and a 
quick-reference summary of requests. 


4.3. Programming Tools 

Contains information of general interest to anyone using UNIX to write programs: 

Programming the Shells 

The C-Sheli or the Bourne Shell can often be used to create tools without the need to write 
programs. 

UNIX Programming 

Describes the programming interface to the UNIX operating system and the stsmdard I/O. 
Lint, A C Program Checker 

Checks G programs for syntax errors, type violations, portability problems, and a variety of 
probable errors. 

Make — A Program for Maintaining Computer Programs 

Indispensable tool for making sure that large programs are properly compiled with minimal 
effort. 

Source Code Control System 

A guide to the Source Code Control System (SCCS) — a system for maintaining and con¬ 
trolling multiple versions of text files. 

DC — An Interactive Desk Calculator 

A superb HP calculator, if you don’t need floating point. 
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BC — Arbitrary Preciaion Deak-Calcvlator Language 

A front end for DC that provides infix notation, control flow, and built<in functions. 

The M4 Macro Proceaaer 

M4 is a macro processor useful as a front end for C, Ratfor, Cobol, and in its own right. 

LEX — A Lexical Analyzer Generator 

Creates a recognizer for a set of regular expressions; each regular expression can be followed 
by arbitrary C code which will be executed when the regular expression is found. 

YACC — Yet Another Compiler Compiler 

Converts a BNF specification of a language and semantic actions written in C into a compiler 
for the language. 

Assembler Manual for the Sun Workstation 
The ultimate dead language. 


4.4. Fortran and Pascal 

Information specific to the FORTRAN and Pascal programming languages. Contents: 

Fortran Programmer’s Guide 

Describes the compiler and run>time system for the new extended language, Fortran 77. 
Also describes the revised I/O library for Fortran 77. 

Ratfor — A Preprocessor for a Rational Fortran 

Converts a Fortran with C*like control structures and cosmetics into real, ugly Fortran. 
System Interface Routines 

FORTRAN interfaces to the basic UNIX supervisor facilities. 

Pascal User’s Manual 

Describes the Berkeley Pascal system. 
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NAME 

intro - introduction to commands 
DESCRIPTION 

This section describes publicly accessible commands in alphabetic order. Certain distinctions of 
purpose are made in the headings: 

(1) Commands'of general utility. 

(1C) Commands for communication with other systems. 

|1G) Commands used primarily for graphics and computer-aided design. 

SEE AL'fO 

S'i^ction 6 for computer games. 

getting Started in the Beginner't Guide to the Sun Worketation. 

DIAGNOSTICS 

Upon termination each command returns two bytes of status, one supplied by the system giving 
the cause for termination, and (in the case of ‘normal* termination) one supplied by the program, 
see wait and exit{2). The former byte is 0 for normal termination, the latter is customarily 0 for 
successful execution, nonzero to indicate troubles such as erroneous parameters, bad or inaccessi¬ 
ble data, or other inability to cope with the task at hand. It is called variously ‘exit code’, ‘exit 
status' or ‘return code’, and is described only where special conventions are involved. 
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NAME 

adb - debugger 
SYNOPSIS 

adb ( -w ] I >k 1 (-Idir ] | objfil ( corfil ] ] 

DESCRIPTION 

Adb is an interactive, general purpose debugger. It examines files and provides a controlled 
environment for the execution of UNIX programs. 

Objfil is normally an executable program file, preferably containing a symbol table. If the file does 
not contain a symbol table, it can still be examined, but the symbolic features of adb cannot be 
used. The default for objfil is a.out. Corfil is assumed to be a core image file produced after exe¬ 
cuting objfil. The default tor corfil is core. 

OPTIONS 

-w Create both, objfil and corfil if necessary and open them for reading and writing so that 
files can be modified using adb. 

-k Do UNIX kernel memory mapping; should be used when core is a UNIX crash dump or 
Idevfmetn. 

-I specifies a directory where files to be read with $< or $<< (see below) wQl be sought; 
the default is luorjlibladb. 

USING j^DB 

Adb reads commands from the standard input and displays responses on the standard output. 
Adb ignores QUIT; INTERRUPT causes return to the next adb command. 

Adb saves and restores terminal characteristics when running a sub-process. This makes it possi¬ 
ble to del^ug programs that manipulate the screen. See Uy(4). 

In general, requests to adb are of the form 

( addreoo] (, count | | command] (;) 

The symbol dot (.) represents the current location. It is initially zero. If addreoo is present then 
dot is set to addreoo. For most commands count specifies how many times the command will be 
executed. The default count is 1. Addreoo and count are expressions. 

EXPRESSIONS 

. The value of dot. 

+ The value of dot incremented by the current increment. 

The value of dot decremented by the current increment. 

& The last addreoo typed. (Used to be 

integer A number. The prefixes Oo and OO (“zero oh”) force interpretation in octal radix; the 
prefixes Ot and OT force interpretation in decimal radix; the prefixes Ox and OX force 
interpretation in hexadecimal radix. Thus 0o20 otlO = 0x10 = sixteen. If no prefix 
appears, then the default radix is used; see the Id command. The default radix is initially 
hexadecimal. The hexadecimal digits are 0123456789abcdefABCDEP with the obvious 
values. Note that a hexadecimal number whose most significant digit would otherwise be 
an alphabetic character must have a Ox (or OX) prefix (or a leading zero if the default 
radix is hexadecimal). 

integer.fraction 

A 32 bit floating point number. 

'cccc' The ASCn value of up to 4 characters. A backslash (‘\’) may be used to escape a 
< name 

The value of name, which is either a variable name or a register name. Adb ^ 
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ADB(1| 

number of variables (see VARIABLES) named by single letters or digits. If name is a 
register name then the value of the register is obtained from the system header in eorfil. 
The register names are those printed by the Ir command. 

eymbol A eymbol is'a sequence of upper or lower case letters, underscores or digits, not starting 
with a digit. The backslash character \ may be used to escape other characters. The 

value of the eymbol is taken from the symbol table in objfil. An initial _ will be 

prepended to symbol if needed. 

^symbol 

In C, the 'true name’ of an external symbol begins with 'J . It may be necessary to use 
this name to distinguish it from internal or hidden variables of a program. 

routine.name 

The address of the variable name in the specified C routine. Both routine and name are 
symbols. It name is omitted the value is the address of the most recently activated C 
stack frame corresponding to routine. 

(ezp ) The value of the expression ezp. 

Unary operators 

*ezp The contents of the location addressed by ezp in corJU. 

%exp The contents of the location addressed by exp in objfii. (Used to be Q.) 

-exp Integer negation. 

~ exp Bitwise complement. 

Logical negation. 

*Ferp (Control-f) Translates program addresses into sourcefile addresses. (Works only if the 
program has been compiled using the -go fiag. See cc(l).) 

“Kexp (Contro!-a) Translates sourcefile addresses into program addresses. (Works only if the 
program has been compiled using the -go flag. See cc(l).) 

'name (Back-quote) Translates a procedure name into a sourcefile address. (Works only if the 
program has been compiled using the -go flag. See cc(I).) 

"^cnoffie” 

A filename enclosed in quotation marks (for instance, ’’main.c”) produces the sourcefile 
address for the zero^th line of that file. Thus to reference the third line of the file main.c, 
we say: ”main.c’’+3. (Works only if the program has been compiled using the -go flag. 
See ee(l).) 

Binary operator! are left associative and are less binding than unary operators. 

el+ e£ Integer addition. 

eJ-et Integer subtraction. 

el*eg Integer multiplication. 

ci^e;? Integer division. 

ei&eS Bitwise conjunction. 

el\et Bitwise disjunction. 

ei^eS El rounded up to die next multiple of eS. 

VARIABLES 

Adb provides a number of variables. Named variables are set initially by adb but are not used 
subsequently. Numbered variables are reserved for communication as follows. 

0 The last value printed. 
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1 The last offset part of an instruction source. 

2 The previous value of variable 1. 

9 The count on the last $< or $<< command. 

On entry the following are set from the system header in the cor fit. If eorfd does not appear to be 
a core file then these values are set from objJU. 

b The base address of the data segment, 

d The data segment size, 

e The entry point. 

m The ‘magic’ number (0407, 0410 or 0413). 
s The stack segment size, 

t The text segment size. 

COMMANDS 

Adb commands consist of a verb followed by a nuxUfler or list of modifiers. 

The verbs are: 

t Print locations starting at addrett in ohjfit. 

/ Print locations starting at address in cor/ll. 

■■ Print the value of addrett itself. 

O Interpret addrett as a sourcefile address, and print locatbns in objfUe or lines of the 
source text. (Works only if the program has been compiled using the -go flag. See 
cc(l).) 

t Manage a subprocess. 

I Execute miscellaneous commands. 

> Assign a value to a variable or register. 

RETURN 

Repeat the previous command with a count of 1. Dot is incremented by its current incre¬ 
ment. 

1 Call the sheik to execute the following command. 

Each verb has a specifie set of modifiers, these are described below. 



( f, /, Q, ■■ ] Modifiers 

The first four verbs described above take the same set of modifiers. These modifiers specify the 
format of command output. Each modifier consists of a letter preceded by an optional repeat 
count; each verb may take one or more modifiers: 

[ ?, /, Q, S3 ] [ ( rcount ] fietter ... ] 

Each time one of these commands is given, dot is incremented by a certain amount (sum of the 
increments specific to each format letter, see below). If a command is given without a modifier, 
the last specified format is used to display output. The following lists the format letter, the 
amount dot increments each time the letter is used, and a description of what each letter does. 


o 

2 

Print 2 bytes in octal. All octal numbers output by adb are preceded by 0. 

O 

4 

Print 4 bytes in octal. 

q 

2 

Print in signed octal. 

Q 

4 

Print long signed octal. 

d 

2 

Print in decimal. 

D 

4 

Print long decimal. 



4 


Last change: 8 March 1984 


Sun Release 1.1 


ADB(l) 


USER COMMANDS 


ADB(l) 


X 2 

X 4 
u 2 
U 4 
f 4 
F 8 
b 1 
c 1 
C 1 

8 n 
8 n 

Y 4 
1 s 


3 0 


I 0 

• 0 


P 4 


Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print as an unsigned decimal number. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. 

Print double floating point. 

Print the addressed byte in octal. 

Print the addressed character. 

Print the addressed character using the standard escape convention: print control 
characters as "X and the delete character as "?. 

Print the addressed characters until a zero character is reached. 

Print a string using the "X escape convention (see C above), n is the length of the 
string including its zero terminator. 

Print 4 bytes in date format (see cftme(3)). 

Print as machine instructions, n is the number of bytes occupied by the instruction. 
In this format, variables 1 and 2 are set to the ofliset parts of the source and destina¬ 
tion respectively. 

Print as machine instructions with 68010 instruction timings, n is the number of 
bytes occupied by the instruction. In this format, variables 1 and 2 are set to the 
oflset parts of the source and destination respectively. 

Print the source text line specifled by dot (Q command) or most closely corresponding 
to dot (7 command). 

^rint the value of doi in symbolic form. Symbols are checked to ensure that they 
^bave an Appropriate type as indicated below. 

/ local or global data symbol 

t local or global text symbol 

ca local or global absolute symbol 

Print the addressed value in symbolic form using the same rules for symbol lookup as 


A 0 
P 4 

t 0 

r 0 
n 0 
0 


+ 


Print tke value of dot in sourceflle symbolic form, that is: ”filename” + nnn. (Works 
only if thi program has been compiled using the -go flag. See ce(l).) 

Print the addreraed value in sourceflle symbolic form, that is: ”filename + nnn. 
(Works on(y if the program has been compiled using the -go flag. See cc(l).) 

When preceded by an integer, tabs to the next appropriate tab stop. For example, 
8t moves to the next 8-space tab stop. 

Print a space. 

Print a newline. 

Print the enclosed string. 

Dot is decremented by the current increment. Nothing is printed. 

Dot is incremented by 1. Nothing is printed. 

Dot is decremented by 1. Nothing is printed. 


[ r, /) Modifiers 
(7/|l value maek 

Words starting at dot are masked with mask and compared with value until a match 
is found. If L is used then the match is for 4 bytes at a time instead of 2. If no 
match is found then dot is unchanged; otherwise dot is set to the matched location. If 
mask is omitted then -1 is used. 
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[f/]w value ... 

Write the ^byte value into the addressed location. If the cranmand is WT, write 4 
bytes. Odd addresses are not allowed when writing to the subprocess address space. 

|?/lm bl el fl[r/\ 

New values tor {bl, el, fl) are recorded. If less than three expressions are given then 
the remaining map parameters are left unchanged. If the or 7’ is followed by 
then the second segment {bS, eS,fS) of the address mapping is changed (see address 
MAPP lNQ, below). If the list is terminated by or ^^e file {objfil or eorfit 

respectively) is used for subsequent requests. (So that, for example, ‘/mV will cause 
7’ to refer to objJU.) 


t Modiflern 

be Set breakpoint at addrete. The breakpoint is executed eounf-l times before causing 

a stop. Each time the breakpoint is encountered the command e is executed. If this 
command is omitted or sets dot to zero then the breakpoint causes a stop. 

Be Like ( but takes a sourcefile address. (Works only if the program has been compiled 

using the -go flag. See ec(l).) 

d Delete breakpoint at addreee. 

D Like d but takes a sourcefile address. (Works only if the program has been compiled 

using the -go Hag. See cc(l).) 

r Run objfil as a subprocess. If addreot is given explicitly then the program is entered 

at this point; otherwise the program is entered at its standard entry pmnt. count 
specifies fibw many breakpoints are to be ignored before stopping. Arguments to the 
subprocess may be supplied on the same line as the command. An argument starting 
with < or > causes the standard input or output to be established for the command. 
All signals are enabled on entry to the subprocess. 

CO The subprocess is continued with signal o, see eigvec{2). If addreto is given then the 

subprocess is continued at this address. If no signal is specified then the signal that 
caused the subprocess to stop is sent. Breakpoint skipping is the same as for r. 

■0 As for c except that the subprocess is single stepped count times. If there is no 

current subprocess then objfil is run as a subprocess as for r. In this case no signal 
can be sent; the remainder of the line is treated as arguments to the subprocess. 

8 Like s but single steps source lines, rather than machine instructions. This is acheived 

by repeatedly single-stepping machine instructions until the corresponding sourcefile 
address changes. (Thus procedure calls cause stepping to stop.) (Works only if the 
program has been compiled using the -«<> Aas* See ee(l).) 

I Add the signal specified by addreto to the list of signals which are passed directly to 

the subprocess with the minimum of interference. Normally, adb intercepts all signals 
destined for the subprocess, and the user must use the te command to continue the 
process with the signal. Signals on this list are handed to the process with an implicit 
tes as soon as they are seen. 

t Remove the signal specified by addreto from the list of signals that are implicitly 

passed to the subprocess. 

k Terminate the current subprocess, if any. 

$ Modifiers 

<file Read commands from the file Jile. If this command is executed in a file, further com* 
mands in the file are not seen. If jUe is omitted, the current input stream is ter* 
minated. It a count is given, and is zero, the command will be ignored. The value of 
the count will be placed in variable P before the first command in /He is executed. 

<.<Jile Similar to <, but catn be used in a file of commands without closing the file. 
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Variable 9 is saved during the execution of this command, and restored when it com¬ 
pletes. There is a (small) finite limit to the number of < < files that can be open at 
once. 

>file Append output to file, which is created if it does not exist. If file is omitted, output 
is returned to the terminal. 

f Print process id, the signal which stopped the subprocess, and the registers. Produces 

the same response as $ used without any modifier, 
r Print the general registers and the instruction addressed by pe. Dot is set to pe. 

b Print all breakpoints and their associated counts and commands, 

e C stack backtrace. If address is given then it is taken as the address of the current 

frame instead of the contents of the frame-pointer register. If count is given then 
only the first count frames are printed. 

C Similar to c, but in addition prints the names and (32 bit) values of all automatic and 

static variables for each active function. (Works only if the program has been com¬ 
piled using the -go flag. See cc(l).) 

d Set the default radix to address and report the new value. Note that address is inter¬ 

preted in the (old) current radbc. Thus “10$d” never changes the default radix. To 
make decimal the default radix, use ‘‘OtlO$d”. 

6 Print the names and values of external variables, 

wr Set the page width for output to address (default 80). 

• Set the limit tor symbol matches to address (default 255). 

o All integers input are regarded as octal, 

q Exit from adb'. 

V Print all non zero variables in octal, 

m Print the address map. 

f Print a list of known source file names, 

p Print a list of known procedure names. 

p {Kernel debugging) Change the current kernel memory mapping to m^ the desig¬ 

nated user structure to the address given by the symbol _u. The address argument 
is the address of the user’s proe structure. 

I Show which signals mre passed to the subprocess with the minimum of adb interfer¬ 

ence. Signals may be added to or deleted from this list using the d and it commands. 
W Re-open objfile and eorfile for writing, as though the -w command-line argument had 

been given. 

ADDRESS MAPPINd 

The interpretation ot an address depends on the context it is used in. If a subprocess is being 
debugged, addresses are interpreted in the usual way (as described below) in the address space of 
the subprocess. If the operating ^stem is being debugged, either post-mortem or by using the 
special file /dev/mem to interactively examine and/or modify memoiy, the maps are set to map 
thf kernel virtual addresses which start at zero. For some commands, the address is not inter¬ 
preted as a memory address at all, but as an ordered pair representing a file number and a line 
number within that file. The Q command always takes such a sourcefile address, and several 
operators are available to convert to and from the more customary core locations. 

The address in a file"associated with a written address is determined by a mapping associated 
with that file. Each mapping is represented by two triples {bl, el, fl) and {bS, e2, f2) and the file 
addrees corresponding to a written address is calculated as follows. 

bl<address<el => file address^address-^ fl-bl, otherwise, 
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h2<adirt99<.eS => file addre99—addre99+ fS-bS, 

otherwise, the requested addre99 b not legal. If a T or / is followed by an * then only the second 
triple is used. 

The initial setting of both mappings b suitable for normal a.out and core flies. If either flle is 
not of the kind expected then, for that flle, bl b set to 0, ei b set to the maximum flle size and fl 
is set to 0; in thb way the whole flle can be examined with no address translation. 

FILES 

a.out 

core 

SEE ALSO 

cc(l), dbx(l), ptrace(2), a.oat(5), core(5) 

U9ing adb to debug the UNIX kernel in the Sun Sgetem Internalo Guide. 

DIAGNOSTICS 

‘Adb* when there is no current command or format. Comments about inaccessible flies, syntax 
errors, abnormal termination of commands, etc. Exit status b 0, unless last eommand faded or 
returned nonzero status. 

BUGS 

There doesn’t seem to be any way to clear all breakpoints. 

Adb uses the embolic information in an old and now obsolete format generated by the -go flag 
of ee(l); it should be changed to use the new format used by the dbx debugger and generated by 

Since no shell b invoked to interpret the argumento of the tr command, the customary wdd-card 
and variable expansions cannot occur. 

Since there b little type-checking on addresses, using a sourceflie address in an inappropriate con¬ 
text may lead to unexpected results: ‘main ft will almost certainly not do anything useful. 
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NAME 

addbib - create or extend bibliogr^hic database 
SYNOPSIS 

addbib | -p promptfile ] ( -a ] database 
DESCRIPTION 

When this program starts up, answering “y” to the initial “Instructions?” prompt yields direc¬ 
tions; typing “n” or RETURN skips them. Addbib then prompts for various bibliographic fields, 
reads responses from the termini, and sends output records to a database. A null response (just 
return) means to leave out that field. A minus sign (-) means to go back to the previous field. 
A trailing backslash allows a field to be continued on the next line. The repeating “Continue?” 
prompt allows the user either to resume by typing “y” or RETURN, to quit the current session by 
typing “n” or “q”, or to edit the database with any system editor (vi, ex, edit, ed). 

The -a option suppresses prompting for an abstract; asking for an abstract is the default. 
Abstracts are ended with a CTRL-d. The -p option causes addbib to use a new prompting skele¬ 
ton, defined in promptfile. This file should contain prompt strings, a tab, and the key-letters to be 
written to the database. 

The most common key-letters and their meanings are given below. Addbib insulates you from 
these key-letters, since it gives you prompts in English, but if you edit the bibliography file later 
on, you will need to know this information. 

%A Author’s name 

Book containing article referenced 
%C City (place of publication) 

%D Date of publication 

%E Editor of book containing article referenced 

%F Footnote number or label (supplied by refer) 

%G Government order number 

%H Header commentary, printed before reference 

%l Issuer (publisher) 

% J Journal containing article 
%K Keywords to use in locating reference 
%L Label field used by ~k option of refer 
%M Bell Labs Memorandum (undefined) 

%N Number within volume 

%0 Other commentary, printed at end ot reference 
%P Page number(s) 

%Q Corporate or Foreign Author (unreversed) 

%R Report, paper, or thesis (unpublished) 

%S Series title 
%T Title of article or book 
%V Volume number 

%X Abstract — used by rofibib, not by refer 
%Y,Z ignored by refer 

Except for ‘A’, each field should be given just once. Only relevant fields should be supplied. An 
example is: 

%A 
%T 
%l 
%C 
' %D 
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%0 UNX 4.3.5. 

FILES 

promptfile optional file to define prompting 

SEE ALSO 

refer(l), 8ortbib(l), roflbib(l), indxbib(l) 
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NAME 

adjacentscreens - notify the window driver of the physical relationships of screens 
SYNOPSIS 

adjaecntnereras [ -e | -m ) center ecreen || -11 -r | -t | -b ] aide aereetJl | -x ] 

DESCRIPTION 

Adjaeentacreena tells the mouse cursor tracking mechanism of the window driver how to move 
between screens that contain windows. Once properly notified using adjaeentacreena, the mouse 
cursor slides from one screen to another when the user moves the cursor off the edge of a screen. 

OPTIONS 

-e center aereen 

The center aereen is a frame buffer device name, such as /dev/fb. All the other physical 
screen positions are relative to this reference point. The -e fiag (c for center) is optional. 
If no further arguments are present on the command line, center aereen is set to have no 
neighbors. 

~m center aereen 

The -m flag (m for middle) may be used instead of -e. 

—I aide aereen 

The aide aereen is also a frame buffer device name, such as IdevjegoneO. The -1 flag 
means that aide aereen is to the /eft of center aereen. Up to four repetitions of “flag aide 
ecreen" may be specified on the command line to define the four neighbors of center 
aereen. 

-r aide aereen 

Like -1, but means that aide aereen is to the right of center aereen. 

—t aide aereen 

Like -I, but means that aide aereen is on <op of center aereen. 

-b aide aereen 

Like —1, but mieans that aide aereen is ielow center aereen. 

—X Suppresses the normal notification to a aide aereen cursor tracker that center aereen is its 
only neighbor. This option is useful if you have a large number of screens or want 
strmige inter>window cursor movement. 

EXAMPLE 

A common configuration would be two screens, a monochrome {/dev/fl) and a color screen 
{f dev/egoneC). Let us assume that the user has set up an instance of auntoola on each screen (the 
window systems must be running before adjaeentacreena is run). He would notify the window 
driver that the color screen was to the right of the monochrome screen by running 
"% adjacentscreens /dey/tb -r /dev/egoneO” in a Shelltool (see auntoola{l)). This sets up cursor 
tracking so that the cursor slides from the monochrome screen to the color screen when the cursor 
moves off the right hand side of the monochrome screen. SimUarly, the cursor slides from the 
color screen to the monochrome screen when the cursor moves off the left hand side of the color 
screen. 

FILES 

/usr/suntool/adjacentscreens 

SEE ALSO 

8untools(l), login(l) 

BUGS 

Window systems on the screens have to be initialized before running adjaeentacreena. It is better 
to run this program just once at boot time in /etc/re.local for example, as physical screen posi¬ 
tions rarely change 


Sun Releas** 1.1 


Last change: 18 January 1984 


11 






ADMIN(l) 


USER COMMANDS 


ADMIN(l) 


NAME 

admin - create and administer SCCS files 
SYNOPSIS 

/usr/aees/ndmln ( -n J ( -I| name) j ( -rrei ) ( -t ( name] | ('•tflag [flag-val \|... ( -dflag [flag- 
va/jI ••• 

( -%login I... I -^login ]... | -m ( mrlitt] || -y (comment] ] ( -h ] ( -a ] file . . . 

DESCRIPTION 

Admin creates new SCCS files and changes parameters of existing ones. Options and SCCS file 
names may appear in any order on the admin command line. SCCS file names must begin with 
the characters ‘a.*. A named file is created if it doesn’t exist already, and its parameters are ini¬ 
tialized according to the specified options. Any parameter not initialized by an option is assigned 
a default value. If a named file does exist, parameters corresponding to specified options are 
changed, and other parameters are left as is. 

If a directory is named, admin behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path name does not begin with n.) 
and unreadable files are silently ignored. A name of — means the standard input — each line of 
the standard input is taken as the name of an SCCS file to be processed. Again, non-SCCS files 
and unreadable files are silently ignored. 

OPTIONS 

Options are explained as though only one named file is to be processed, since options apply 
independently to each named file. 

A new SCCS file is being crested. 

-l(name] 

Initial text: the file name contains the text of a new SCCS file. The text is the first delta 
of the file — see -r option for delta numbering scheme. If name is omitted, the text is 
obtained from the standard input. Omitting the -1 option altogether creates an empty 
SCCS file. You can only create one SCCS file with an ndmln -1 command. Creating 
more than one SCCS file with a single admin command requires that they be created 
empty, in which case the -1 option should be omitted. Note that the -1 option implies 
the —n option. 

-r rel Initial release: the release into which the initial delta is inserted. —r may be used only if 
the —1 option is also used. The initial delta is inserted into release 1 if the —r option is 
not used. The level of the initial delta is always 1, and initial deltas are named 1.1 by 
default. 

-tjname] 

Descriptive text: The file name contains descriptive text for the SCCS file. The descrip¬ 
tive text file name must be supplied when creating a new SCCS file (either or both -n and 
-I options) and the -t option is used. In the case of existing SCCS files: 1) a -t option 
without a file name removes descriptive text (if any) currently in the SCCS file, and 2) a 
-t option with a file name replaces the descriptive text currently in the SCCS file with 
any text in the named file. 

Set flag: specifies a flag, and, possibly, a value for the flag, to be placed in the SCCS file. 
Several —f options may be supplied on a smgle admin command line. Flaga and their 
values appear in the FLAGS section after this list of options. 

Delete flag from an SCCS file. The —<1 option may be specified onty when processing 
existing SCCS files. Several -d options may be supplied on a single admin command. See 
the FLAGS section below. 

Unlock the specified list of releases. See the -•f option for a description of the 1 fiag and 
the ^ntax of a list. 


-tflag 

-dflag 

-Mist 
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-a login 

Add login name, or numerical UNIX group ID, to the list of users who may make deltas 
(changes) to the SCCS file. A group ID is equivalent to specifying all login names common 
to that group ID. Several -a options may appear on a single admin command line. As 
many logins, or numerical group IDs, as desired may be on the list simultaneously. If the 
list of users is empty, anyone may add deltas. 

-e login 

Erase login name, or numerical group ID, from the list of users allowed to make deltas 
(changes) to the SCCS file. Specifying a group ID is equivalent to specifying all login 
names common to that group ID. Several -e options may be used on a single admin com¬ 
mand line. 

—yjcemmenl) 

The comment text is inserted into the SCCS file as a comment for the initial delta in a 
manner identical to that of delta{l). If the -y option is omitted, a default comment line 
is inserted in the form: 

date and time created YY/MM/DD HH:MM:SS by login 

The ~y option is vidid only if the -1 and/or -n options are specified (that is, a new SCCS 
file is being created). 

-m[ mr/tri] 

The list of Modification Requests (MR) numbers is inserted into the SCCS file as the rea¬ 
son for creating the initial delta in a manner identical to delta{l). The v flag must be set 
and the MR numbers are validated if the v flag has a value (the name of an MR number 
validation program). Diagnostics are displayed if the v flag is not set or MR validation 
fails. 

—h Check the structure of the SCCS file (see ace8file{5)), and compare a newly computed 

check-sum (the sum of all the characters in the SCCS file except those in the first line) 
with the check-sum that is stored in the first line of the SCCS flle. 

The -h option inhibits writing on the flle, so that it nullifies the effect of any other 
options supplied, and is, therefore, only meaningful when processing exuting files. 

-s recompute the SCCS file check-sum and store it in the first line of the SCCS file (see -h, 
above). 

Using the -a '^tion on a truly corrupted file may prevent future detection of the corrup¬ 
tion. 

FLAGS . 

The list below is a description of the flage which may appear as arguments to the -f (set flags) 
and -d (delete flags) options. 

b When set, the -b option can be used on a get(l) command to create branch deltas. 

e ceil The highest release (ceiling) which may be retrieved by a 0 ei(l) command tor editing. 

The ceiling is a number less than or equal to 9999. The default value for an unspecified c 
flag is 9999. 

e floor The lowest release (floor) which may be retrieved by a get(l) command for editing. The 
floor is a number greater than 0 but less than 9999. The default value for an unspecified 
f flag is 1 . 

d S/D The default delta number (SID) to be used by a gel(l) command. 

1 Treats the ‘No id keywords (ge 6 )’ message issued by get(\) or delta{l) as a fatal error. In 

the absence oF^the I flag, the message is only a warning. The message is displayed if no 
SCCS identification keywords (see 9 ri(l)) are found in the text retrieved or stored in the 
SCCS file. 
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J Concurrent ;e((l) commands for editing may apply to the same SID of an SGCS file. This 

allows multiple concurrent updates to the same version of the SCGS file. 

A list of locked releases to which deltas can no longer be made. A get-« fails when 
applied against one of these locked releases. The list has the following syntax: 

<list> 

<range> RELEASE NUMBER | a 

The character a in the K$t is equivalent to specifying aU releaeet for the named SGGS file. 

n The detta{l) command creates a ‘null* delta in each release (if any) being skipped when a 
delta is made in a new release. For example, releases 3 and 4 are skipped when making 
^elta 5.1 after delta 2.7. These null deltas serve as ‘anchor points’ so that branch deltas 
may be created from them later. If the n flag is absent from the SGGS file, skipped 
releases will be non-exbtent in the SGGS file, preventing branch deltas from being created 
from them in the future. 

q text Text is defined by the user. The text is substituted for all occurrences of the %Q% key¬ 
word in SGGS file text retrieved by get(l). 

m moJuie 

Module name of the SGGS file substituted for all occurrences of the %M% keyword in 
SGGS file text retrieved by get{l). If the m flag is not specified, the value assigned is the 
name of the SGGS file with the leading s. removed. 

t type Type of module in the SGGS file substituted for all occurrences of %Y% keyword in SGGS 
file text retrieved by get{l). 

v( program] 

Validity checking program: delta{l) prompts for Modification Request (Ml) numbers as 
the reason for creating a delta. The optional program specifies the name of an MR 
number validity checking program (see detta{l)). If this flag is set when creating an SGGS 
file, the -m option must also be used even if its value is null. 

files 

The last component of all SGGS file names must be of the form u.JUe-name. New SGGS files are 
given mode 444 (see eAimod(l)). Write permission in the pertinent directory is, of course, required 
to create a file. All writing done by admin is to a temporary x-flle, called x.file-name, (see pe((l)), 
created with mode 444 if the admin command is creating a new SGGS file, or with the same mode 
as the SGGS file if it exists. After successful execution of admin, the SGGS file is removed (if it 
exists), and the x-file is renamed with the name of the SGGS file. This ensures that changes are 
made to the SGGS file only if no errors occurred. 

It is recommended that directories containing SGGS files be mode 755 and that SGGS Oies them¬ 
selves be mode 444. The mode of the directories allows only the owner to modify SGGS files con¬ 
tained in the directories. The mode of the SGGS files prevents any modification at all except by 
SGGS commands. 

If it should be necessary to patch an SGGS file for any reason, the mode may be changed to 644 
by the owner allowing use of a text editor. ”Care muet be takenF The edited file should alwayt 
be processed by an admin -h to check for corruption followed by an admin -a to generate a 
proper check-sum. Another admin -h is recommended to ensure the SGGS file is valid. 

Admin also uses a transient lock file (called Xtfile-name), to prevent simultaneous updates to the 
SGGS file by different users. See pe((l) for further information. 

SEE ALSO 

sccs(l), delta(l), ed(l), get(l), help(l), prs(l), what(l), sccsfile(5). 

Source Code Control System in Programming Tools for the Sun Workstation, 
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DIAGNOSTICS 

Use help(l) for explanations. 
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AR(1) user commands AR(1) 

NAME 

ar - archive and library maintainer 

SYNOPSIS 

•r drqtpmx (vuaibelo ] ( poename ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive/library file. It is normally used to 

create and update library files used by the loader; it can be used, though, for any similar purpose. 

One of the mandatory keys (drqtpmx) must be used; it may be foUowed by one or more of the 

modifiers vuaibelo. Afilt is the archive file. The names are constituent files in the archive file. 

OPTIONS 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. 

q Quick append. Append the named files to the end of the archive file without searching 
the archive for duplicate names. Useful only to avoid quadratic behavior when creating a 
large archive piece>by*piece. 

t Display a table of contents of the archive file. If no names are given, all files in the 
archive are listed; if names are given, only those files are listed. 

p Display the named files in the archive. 

m Move the named files to the end of the archive. 

X Extract the named files. If no names are given, all files in the archive are extracted. In 

neither case does x alter the archive file. 

MODIFIERS 

V Verbose. Give a file>by>file description of the creation of a new archive file from the old 
archive and the constituent files. When used with it gives a long listing of aQ informa¬ 
tion about the files. When used with p, it precedes each file with a name. 

e Ar creates afile when it needs to, and displays a message to this effect. The e modifier 
suppresses this message. 

1 Local. Ar places its temporary files in the directory /tmp. The 1 modifier places them in 
the local directory. 

o Old date. When files are extracted with the x option, o sets the “last modified” date to 
the date recorded in the archive. 

u Replace only those files that have changed since they were put in the archive. Used with 
the r option. 

• Place new film after pomame (poename argument must be present). Applies only with 
the r and m options. 

b Place new files before posname (poename argument must be present). Applies only with 
the r and m options. 

1 Identical to the b modifier. 

FILES 

/tmp/v* temporaries 

SEE ALSO 

lorder(l), ld(l), ranlib(l), ar(5) 

BUGS 

If the same file is mentioned twice in an argument list, it is put in the archive twice. 
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The 1a6t»modified’ date of a file will not be altered by the o option unless the user is either the 
owner of the extracted file or the super-user. 
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NAME 

as - inc68000 assembler 
SYNOPSIS 

M I -<12 ] I -J ] (-L ] (-R ] (-o objfile ] file 
DESCRIPTION 

At translates assembly code in the named jUt into executable object code in the specified objfile. 
All undefined symbols in the assembly are treated as global. 

The output of the assembly is left in the file objfile. If that is omitted, and the source file name 
has the form zzz.8, then file n.nuMs used. 

OPTIONS 

-dS Specifies that instruction offsets which involve forward or external references, and which 
have sizes unspecified in the assembly language are two bytes long. The default is four 
bytes. See also 

-L Save defined labels beginning with an ‘L’, which are normally discarded to save space in 
the resultant symbol table. The compilers generate such temporary labels. 

-J Use short (pc relative) branches to resolve jump’s and jsr’s to externals. This is for com¬ 
pact programs which cannot use the -dS flag because of the large program relocation. 

-R Make initialized data segments read-only, by concatenating them to the text segments. 
This eliminates the need to run editor scripts on assembly code to make initialized data 
read-only and shared. 

FILES 

/tmp/as* default temporary file 

SEE ALSO 

ld(l), nm(l), adb(l), dbx(l), a.out(5) 

The “Attembler Referenee Manual for the Sun Worketation” in the Sun Programming Toole 
Manual. 

BUGS 

Should assemble standard input with no arguments. 

The Pascal compiler (pc(I)) qualifiles a nested procedure name by chaining the names of the 
enclosing procedures. This sometimes results in names long enough to abort the assembler, which 
currently limits identifiers to 60 characters. 
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NAME 

at - execute commaods at a later time 

SYNOPSIS 

at time [ day ] [ file ] 

DESCRIPTION 

At squirrels away a copy of the named file (standard input default) to be used as input to e/i(l) or 
eeA(l) at a specified later time. At inserts a cd command to the current directory at the begin¬ 
ning of the copy file, and follows this with assignments to all environment variables (except 
TERM, which is useless in this context.) When the script is run, it uses the user and group ID of 
the creator of the copy file. 

Time is specified by from 1 to 4 digits, and may be followed by ‘a’, ‘p’, ‘n’ or ‘m’ for AM, PM, 
noon, or midnight (letters may be upper or lower case). One and two digit numbers are taken to 
be hours, three and four digits to be hours and minutes. If no letters follow the digits, a 24 hour 
clock time is understood. 


Day may be either a month name followed by a day number — for example, *apr 26’ — or a day 
of the week — ‘weds’, for instance. If you name a day of the week and follow this with the word 
‘week’ — ‘weds week’ — invocation is moved seven days further off. Names of months and days 
may be recognizably truncated. 

programs are executed by periodic execution of the conunand fuerfliblatrun from eron(8). 
The granularity of afdepends upon how often atrun is executed. 

Standard output or error output is lost unless redirected. 


EXAMPLES 

Examples of legitimate commands are: 
at 8a jao 24 


at 1630 fr week 


FILES 

/usr/Ub/atrun 


in /usr/spool/at: 

yy.ddd.hhhh.* 

lasttiroedone 

past 


executor (run by eron(8)). 


activity for year yy, day dd, hour hhhh. 
last hkkh 

activities in progress 


SEE ALSO 

caiendar(l), pwd(l), sleep(l), cron(8) 

BUGS . 

Due to the granularity of the execution of f utrfHbf atrun, there may be bugs in scheduling things 
almost exactly 24 hours into the future. 
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NAME 

awk - pattern scanoi&g and processing language 
SYNOPSIS 

»wk (-f programJHe J ( -Fc j { program ) [ ... J 

DESCRIPTION 

Awk scans each of its input filet tot lines that match any of a set of patterns specified in program. 
The input filet are read in order; the standard input is read if there are no filet. The filename 
means the standard input. 

The set of patterns may either appear literally on the command line as program, or, by using the 
-f option, the set of patterns may be in a programJUe. 

With each pattern in program there can be an associated action that will be performed when a 
line of a file matches the pattern. See the discussion below for the format of input lines and the 
awk language. Each line in each input file is matched against the pattern portion of every 
pattern-action statement; the associated action is performed for each matched pattern. 

OPTIONS 

-t program_JUe 

Use the contents of programJUe as the source for the program. 

-F e Use the character e as the field separator (FS) character. See the discussion of FS below. 

LINES, STATEMENTS, AND THE AWK LANGUAGE 
Input Linns 

An input line is made up of fields separated by white space. The field separator can be changed 
by using PS — see below. Fields are denoted $1, $2,... up to $9; $0 refers to die entire line. 

Pnttern-netlon Statements 
A pattern-action statement has the form 

pattern { action } 

A missing { action } means copy the line to the output; a missing pattern always matches. 

An action is a sequence of statements. A statement can be one of the following: 

if ( conditional) statement | else statement ] 

while ( conditional) statement 

for ( expression ; conditional; expression ) statement 

break 

continue 

{(statement)...} 

variable expression 

print ( expression-list ] [ >expression ) 

printf format (, expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Format of the Awk Language 

Staiemente are terminated by semicolons, newlines or right braces. An empty expression-list 
stands for the whole line. 

Ezpreeeiont take on string or numeric values as iq>pr<d>riate, and are built using the operators -t-, 
-> *> /, %, nnd concatenation (indicated by a blank). The C operators *4* •!•, —, + ■*, *=», 

/=*, and %=* are also avaUable in expressions. 

Variablet may be scalars, array elements (denoted x(i]) or fields. Variables are initialized to the 
null string. Arrso^ subscripts may be any string, not necessarily numeric, providing a form of 
associative memory. String constants are quoted 
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The print statement prints its arguments on the standard output (or on a file if >file is present), 
separated by the current output field separator, and terminated by the output record separator. 
The print/ statement formats its expression list according to the format template (see printf{3S) 
for a description of the formatting control characters). 

S tuilt &a Functions 

'he built>in function length returns the length of its argument taken as a string, or of the whole 
ne if no argument. There are also built-in functions exp, log, eqrt, and int, where int truncates 
||3 argument to an integer. $ubstr(s, m, n) returns the n-character substring of s that begins at 
npsition m. The sprintffformat, expr, ezpr, ...) function formats the expressions according to the 
l^rintf{3S) format given by format and returns the resulting string. 

P&tteriM 

Patterns are arbitrary Boolean combinations (!, ||, &&, and parentheses) of regular expressions 
relational expressions. Regular expressions must be surrounded by slashes and are as in 
egrep. Isolated regular expressions in a pattern apply to the entire line. Regular expressions may 
also occur in relational expressions. 

A pattern may consist of two patterns separated by a commit in this case, the action is performed 
for all lines between an occurrence of the first pattern and the next occurrence of the second. 

A relational expression is one of the following: 

expression maiehop regular-expression 
expression retop expression 

where a relop is any of the six relational operators in C, and a matehop is either ~ (for contains) 
or !" (for does not contain). A conditional is an arithmetic expression, a relational expression, or 
a Boolean combination of these. 

I 

The special pattern BEGIN mao^ be used to capture control before the first input line is read, in 
which case BEGIN must be the first pattern. The special pattern END may be used to capture 
control after the last input line is read, in which case END must be the last pattern. 

Special Variable Names 

A single character c may be used to separate the fields by starting the program with 
BEGIN { FS = ”c” } 
or by using the -Fe option. 

Other variable names with special meanings include NF, the number of fields in the current 
record; NR, the ordinal number of the current record; FILENAME, the name of the current input 
file; OFS, the output field separator (default blank); ORS, the output record separator (default 
newline); mid OFMT, the output format for numbers (default ’’%.6g’’). 

EXAMPLES 

Print lines loiiger than 72 characters: 
length > 72 

Print first two fields in opposite order: 

{ print $2, $1 } 

Add up first column, print sum and average: 

{.+-$ 1 } 

END { print "sum is", s, * average is”, s/NR } 

Print fields in reverse order: 

{ for (i =s NF; i > 0; —i) print $i } 

o 
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Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose first field is different from previous one: 

$1!— prev { print; prev a $i } 

SEE ALSO 

lex(l), 8ed(l) 

Pattern Scanning and Proeeteing with Awk in the Sun Editing and Text Proeetring Manu^. 

BUGS 

There are no explicit conversions between numbers and strings. To force an expression to be 
treated as a number add 0 to it; to force it to be treated as a string concatenate ”” to it. 
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NAME 

baseaame - strip filename affixes 
SYNOPSIS 

basename string (snffix ] 

DESCRIPTION 

Baeename deletes any prefix ending in '/’ and the suffix, if present in string, from string, and 
directs the result to the standard output. It is normally used inside substitution marks ' * in shell 
procedures. 

EXAMPLE 

This shell procedure invoked with the argument fusrfsrclcmdfcat.c compiles the named file and 
moves the output to eat in the current directory: 

cc $1 

mv a.out 'basename $1 .c' 

SEE ALSO 

6h(i) 
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NAME 

be - arbitrary-precisioB arithmetic language 
SYNOPSIS 

be I —e j I —111 fil® • • • 1 
DESCRIPTION 

Be is an interactive processor for a language which resembles C but provides unlimited precision 
arithmetic. Be takes input from any files given, then reads the standard input. The qrntax for be 
programs is as follows; L means letter a"!, E means expression, S means statement. 

Comments 

are enclosed in /* and */. 

I^pmes 

'' simple variables: L 
array elements: L ( E | 

The words ‘ibase’, ‘obase’, and ‘scale’ 

Other operands 

arbitrarily long numbers with optional sign and decimal point. 

(E) 

sqrt (E) 

length ( E ) number of significant decimal digits 
scale ( E ) number of digits right of decimal point 
L ( E , •••, E ) 

Operators 

+ -*/%*(% is remainder; * is power) 

■f -f — (prefix and postfix; apply to names) 

"" '7 

Statements 

E 

{ S ;; S } 

if ( E ) S 

whUe(E)S 

for ( E ; E ; E ) S 

null statement 

break 

quit 

Function definitions 

define I# (I. ,..., I. ) ( 
auto U,..., I. 

S;... S 
return (E) 

} 

Functions in -1 math library 
8(x) sine 

c(x) cosine 
e(x) exponential 
l(x) log 

a(x) arctangent 
j(n,x) Bessel function 
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All f^Qetioa arguments are passed by value. 

The value of a statement that is an expression is printed unless the main operator is an assign¬ 
ment. Either semicolons or newlines may separate statements. Assignment to scale influences the 
number of digits to be retained on arithmetic operations in the manner of dc(l). Assignments to 
ibase or abase set the input and output number radix respectively. 

The same letter may be used as an array, a function, and a simple variable simultaneously. All 
variables are global to the program. *Auto’ variables are pushed down during function calb. 
When using arrays as function arguments or defining them as automatic variables empty square 
brackets must follow the array name. 

EXAMPLES 

Define a function to compute an approximate value of the exponential function; 
scale = 20 
define e(x){ 

auto a, b, c, 1, s 
a 3=3 1 
l) m 1 
8 sas 1 

for(i*a»l; i+ +){ 

a =* a*x 
b b*i 
c as a/b 

if(c non 0) retttrn(8) 

8 ss» 8+C 

> 

} 

Print approximate valuea of the exponential function of the first ten integers: 
for(i=.l; i<=»10; i+ + ) e(i) 

OPTIONS 

-I is the name of an arbitrary precision math library. 

-e Compile only: be is actually a preprocessor for (fc(l), which it invokes automatically, 
unless the -e (compile only) option is present. In this case the ic input is sent to the 
standard output instead. 

FILES ! 

/usr/lib/Ub.b mathematical library 
dc(l) desk calculator proper 

SEE ALSO 
dc(i) 

L. L. Cherry and R. Morris, BC - An arbitrary preeUicn desk-calculator language 

BUGS 

No &&, 11> or I operators. 

For statement must have all three E’s. 

Quit is interpreted when read, not when executed. 
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NAME 

biff - mail alann 

SYNOPSIS 

biff(yn] 

DESCRIPTION 

BiffMonm the system whether you want to be notified when mail arrives daring the current ter> 
minal session. The command: 

biff y 

enables notification; the command: 

biff n 

(llsables it; finally, the command: 

biff 

oh its own tells you whether the notification is y or n. When mail notification is enabled, the 
header and first few lines of the message are printed on your screen whenever mail arrives. 
A biff y command is often included in the file .login or .profile to be executed at each login. 

Btiir operates asynchronously. For synchronous notification use the MAIL variable of sA(l) or the 
mail variable of e«h(l). 

SEE ALSO 

C8h(l), sh(l), mail(l) 




c 
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NAME 

/bin/mail - send or receive mail among users 
SYNOPSIS 

/bin/mall i + ] ( -11 ( person | ... 

/bln/maU [ + ] [ ~l ] -f 

DESCRIPTION 

Note: This is the old version 7 UNIX system mail program. The default mail command is 
described in mai7(l), and its binary is in the directory fusrlucb. 

/bin/mail with no argument prints a user's mail, message-by-message, in last-in, first-out order; 
the optional argument + displays the mail messages in first-in, first-out order. For each message, 
/bin/mail reads a line from the standard input to direct disposition of the message. 

>Yhen persona are named, /bin/mail takes the standard input up to an end-of-file (or a line with 
just *•’) and adds it to each personas 'mail' file. The message is preceded by the sender's name 
and a postmark. Lines that look like postmarks are prepended with '>’. A person is usually a 
user name recognized by /opn(l). 

If there is any pending mail, /bin/mail tells you there is mail when you log in. It is also possible 
to have the C-Shell, see esA(l) or the comsat daemon ^(^1) tell you about mail that arrives while 
you are logged in. 

COMMANDS 

newline Go on to next message, 
d Delete message and go on to the next, 
p Print message again. 

- Go back to previous message. 

8 I j ... 

Save the message in the named filt$ (‘mbox’ default), 
w I ] ... 

Save the message, without a header, in the named file$ (‘mbox’ default), 
m I pereon j ... 

Mail the message to the named pertona (yourself is default). 

EOT (control-D) 

Put unexamined mail back in the mailbox and stop, 
q Same as EOT. 

I command 

Escape to the Shell to do command. 

* Print a command summary. 

OPTIONS 

Display mail messages in first-in, first-out order. 

—t file Use/fie as if it were the mail file. 

-1 Continue after interrupts — an interrupt normally terminates the fbinimail command 
and leaves the mail file unchanged. 

FILES 

/etcfpasswd to identify sender and locate persons 

/nsr/spool/mail/* incoming mail for user * 

mbox saved mail 

/tmp/ma* temp file 

/usr/spool/mail/^.lock lock for mail directory 
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dead .letter unmailable text 

SEE ALSO 

biir(l), write(l), uucp(lC), uux(lC), X8end(l), 8endmail(8) 

BUGS 

Race conditions sometimes result in a failure to remove a lock file. 

Normally anybody can read your mail, unless it is sent by x$end{l). An installation can overcome 
this by making f bin/mail a set>u8er>id command that owns the m^ directory. 



c 
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NAME 

cal - display calendar 

SYNOPSIS 

cal I month ] year 

DESCRIPTION 

Cal displays a calendar for the specified year. If a month is also specified, a calendar for that 
month only is displayed. 

Year can be between 1 and 9999. Be aware that 'eat 78' refers to the early Christian era, not the 
20th century. Also, the year is always considered to start in January, even though this is histori¬ 
cally naive. 

Month is a number between 1 and 12. 

The calendar produced is that tor England and her colonies. 

Try September 1762. 


o 
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NAME 

calendar - reminder service 

SYNOPSES 

«^lend»r (-) 

DESCRIPTION 

Calendar consults the file calendar in the current directory and displays lines that contain today’s 
or tomorrow’s date anywhere in the line. Most reasonable month-day dates — such as ‘Dec. 7,’ 
‘december 7,’ and ‘12/7’ — are recognised; but ‘7 December’ or ‘7/12’ are not. If you give the 
month as with a date — for example, “* 1” — that day in any month will do. On weekends 
‘tomorrow’ extends through Monday. 

When the optional - argument is present, calendar does its job for every user who has a file calen¬ 
dar in hu login directory and sends him any positive results by mat/(l). Normally this is done 
daily in the wee hours under control of cron(8). 

The file calendar is first run through the C preprocessor, Ilib/cpp, to include any other calendar 
files specified with the usual “#include” syntax. Included calendars are usually shared by all 
users, and maintained by the qrstem administrator. 

FILES 

'/calendar 

/usr/lib/calendar to figure out today’s and tomorrow’s dates 

/etc/passwd 

/tmp/cal* 

/lib/cpp subprocess 

/usr/bin/egrep subprocess 
/bin/sed subprocess 

/bin/mail subprocess 

SEE ALSO 

at(l), cron(8), mail(l) 

BUGS 

Calendar’* extended idea of ‘tomorrow’ doesn’t account for bolides. 



o i 

i 
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NAME 

cat - concatenate and display 
SYNOPpiS 

^at (-u 1 ( -n 1 (-b J I -• ) I -V H -e 1 ( -t 1 I - j 1 file ... I 
DESCRIPTION 

Cat reads each filt in sequence and displays it on the standard output. Thus 
% eat goodies 

displays the contents of goodies on the standard output, and 

% eat fllel flIeS >flle3 

concatenates the first two files and places the result on the third. 

If no filename argument is given, or if the argument is given, eat reads from the standard 
input file. If the standard input is a terminal, input is terminated by a "D. 

OPTION^ 

makes the output completely unbuffered. If -u is not used, output is buffered in 1024- 
I byte blocks, or line-buffered if standard output is a terminal. 

-n precedes each line output with its line number. 

-b numbers the lines, as -n, but omits the line numbers from blank lines. 

-■ substitutes a single blank line for multiple adjacent blank lines. 

-V displays non-printing characters so that they are visible. Control characters print like 

for control-x; the delete character (octal 0177) prints as '?. Non-ASCII characters (with 
the high bit set) are displayed as M- (for meta) followed by the character of the low 7 
bits. 

-e displays non-printing characters, as -v, and in addition displays a *$* character at the end 
of each line. 

-|| displays non-printing characters, as -v, and in addition displays tab characters as 
SEE ALSO 

cp(l), ex(l), more(l), pr(l), tail(l) 

BUGS 

Beware of 'cat a b >a’ and 'cat a b >b’, which destroy the input files before reading them. 
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NAME 

cb - C program beautifier 

SYNOPSIS 

eb 

DESCRIPTION 

Ci places a copy of the C program from the standard input on the standard output with spacing 
and indentation that displays the structure of the program. 
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NAME 

cc - C compiler 

SYNOPSIS 

ec (-c ) I -« 1 ( -go j (-w ) ( -p 11 -pg ) I -O 11 -R11 -fslngle J (-fsky | | -S j 
I -E 11 -C 1 (-o output ) {-D name^def | | -D name j ( -U nome) (-1 dir ) 

( -B string ] ( -t ( p012 ] ] file ... 

DESCRIPTION 

Ce is the UNIX C compiler which translates programs written in the C programming language 
into executable load modules, or relocatable binary programs for subsequent loading with the 
ld{l) linker. In addition to the many flag arguments (options) ce accepts several types of flies: 
flies whose names end with .c are taken to be C source programs; they are compiled, and each 
o|^ject program is left on the file whose name is that of the source with *o substituted for .c. The 
ec file is deleted if a single C program is compiled and loaded aU at once. 

In the same way, files whose names end with •$ are taken to be assembly source programs and are 

assembled) ib^oducing a .0 file. 

OPTIONS 

The following options are interpreted by ce. See W(l) for load-time options. 

-e Compile only: suppress the load phase of the compilation, and force an object file to be 
produced even if only one program is compiled. 

Have the compiler produce additional i^mbol table information for dbx{l). Ako pass the 

-If flag to ld{l). 

-go Have the compiler produce additional symbol table information in an older format which 
was used by the $db debugger and can still be used by the odi(l) debugger, which has 
not yet been converted to the new format of -g. Also pass the -Ig flag to 

-w Suppress warning messages. 

-p Produce profiling code to count the number of times each routine is called. If loading 
takes place, replace the standard startup routine by one that automatically calls moni- 
tor{d) and use a special profiling library in lieu of the standard C library. When the pro¬ 
gram is run, the file monuout is created and an execution profile can be generated with 
prof{l). An execution profile can then be generated by use of proJ[l). 

"”Pg Produce profiling code in the manner of —p, but invokes a run-time recording mechanism 
that keeps more extensive statistics and produces a gmoriuout file at normal termination. 
gpr 0 f{l) generates an execution profile. 

-O Use the object code optimizer to improve the generated code. 

-E Passed on to a$, making initialized variables shared and read-only. 

-falngln 

Use single-precision arithmetic in computations involving only float numbers — that is, 
do not convert everything to double which is the default case. Note that floating-point 
parameters are still converted to double-precision, and functions which return values still 
return double-precision values. Certain programs run much faster using this option, but 
be aware that some significance can be lost due to lower precision intermediate values. 

—fsky Generate code which assumes the presence of a SKY floating-point processor board. Pro¬ 
grams compiled with this option can only be run in systems that have a SKY board 
installed. Programs compiled without the -fsky option will use the SKY board, but 
won’t run as fast as they would if the —fsky option were used. If any part of a program 
is compiled using the -fsky option, you must also use this option when linking with the 
cc command, since a different set of startup routines is used. 

-S Compile the named C programs, and leave the assembler-language output on 
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corresponding files suffixed '.s’. 

-E Run only the macro preprocessor on the named C programs, and send the result to the 
standard output. 

-C Prevent the macro preprocessor from removing comments. 

-o output 

Name the final output file output. If this option is used, the file a.out is left undis* 
turbed. 

-Dname^^def 

-Dname Define name to the preprocessor, as if by '#define’. If no definition is given, the name is 
defined as ”1”. 

-Unsme Remove any initial definition of name. 

-Idir ‘#inclade’ files whose names do not begin with '/’ are always sought first in the direc¬ 
tory of the JUe argument, then in directories named in -I options, then in the 
/uor/inetude directory. 

-Botring Find substitute compiler passes in the files named etring with the suffixes cpp, ccom and 
c2. If etring is empty, use a standard backup version. 

-t(p01S| 

Find only the designated compiler passes in the files whose names are constructed by a 
-B option. In the absence of a -B option, the otring is taken to be JuirfnewJ. The 
letter/number combinations that can be specified for the -t option have the meanings: 

P cpp — the C preprocessor. 

0 ccom — both passes of the C compiler but excluding the optimizer. 

1 Ignored in this system — this option would be for the second phase of a two>phase 
compiler but in the Sun system, ccom includes both phases. 

2 cS — the C optimizer. 

Other arguments are taken to be either loader option arguments, or C-compatible object pro¬ 
grams, typically produced by an earlier cc run, or perhaps libraries of C-compatible routines. 
Unless -e, -S, or -B is specified, these programs, together with the results of any compilations 
specified, are loaded (in the order given) to produce an executable program with name a.out. The 
name a.out can be overridden with the loader’s -oname option. 

FILES 

file.c 
file.o 
a.out 

/tmp/ctm? 

/lib/cpp 
/lib/ccom 
/usr/c/occom 
/usr/c/ocpp 
/lib/c2 
/lib/crtO.o 
/lib/mcrtO.o 
/usr/lib/gcrtO.o 
/lib/fcrtO.o 
/lib/fmcrtO.o 
/usr/Iib/fgcrtO.o 
/lib/Ubc.a 
/usr/lib/Ubc_p.a 
/usr/include 
mon.out 


input file 

object file 

loaded output 

temporary 

preprocessor 

compiler 

backup compiler 

backup preprocessor 

optional optimizer 

runtime startoff 

startoff for profiling 

startoff for gprof-profiling 

SKY runtime startoff 

SKY startoff for profiling 

SKY startoff for gprof-profiling 

standard library, see intro(3) 

profiling library, see intro{3) 

standard 4irectoiy f 9 r ‘^include’ files 

hie prod’OiCc'd for analysis by proJ{l) 
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gmon.out file produced for anafysis by gpro][\) 

SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978 
UNIX Programming in Programming Toole for the Sun Workstation. 
inonitor(3), prof(l), gprof(l), adb(l), ld(l), dbx(l), a8(l), diff(l) 

DIAGNOSTICS 

The diagnostics produced by C itself are intended to be self-explanatory. Occasional messages 
may be produced by the assembler or loader. 
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NAME 

cd - chaoge working directory 

SYNOPSIS 

ed (directory ] 

DESCRIPTION 

Directory becomes the new working directory. The process must have execute (search) permission 
in directory. If cd is used without arguments, it returns you to your login directory. In c«A(l) 
you may specify a list of directories in which directory is to be sought as a subdirectory if it is not 
a subdirectory of the current directory; see the description of the cdpatk variable in cah{l). 

SEE ALSO 

esh(l), sb(l), pwd(l), chdir(2) 
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NAME 

cdc - change the delta commentaiy of an SGGS delta 
SYNOPSIS 

ede -rSID [ -m [mrlist] ] [ -y [comment] ] file ... 

DESCRIPTION 

Cde changes the delta commentary, for the SID specified by the -r option, of each named SGGS 
file. 

Delta commentary is defined to be the Modification Request (MR) and comment information nor^ 
mally specified via the delta{l) command (-m and -y options). 

If a directory is named, ede behaves as though each file in the directory were specified as a named 
file, except that non>SGGS files (last component of the path name does not begin with a.) and 
unreadable files are silently ignored. If a name of - is given, the standard input is read (see 
WARNINGS)', each line of the standard input is taken to be the name of an SGGS file to be pro¬ 
cessed. 

Arguments to ede, which may appear in any order, consist of options and file names. 

OPTIONS 

All the described options apply independent^ to each named file: 

-vSlD Specifies the 5GGS /Dentification {SID) string of a delta for which the delta commen¬ 
tary is to be changed. 

-m| mrlist] If the SGGS file has the v flag set (see a(/mtn(l)), a list of MR numbers to be added 
and/or deleted in the delta commentary of the SID specifled by the -r option may be 
supplied. A null MR list has no effect. 

MR entries are added to the list of MRs in the same manner as that of delta{l). In 
order to delete an MR, precede the MR number with the character ! (see EXAM¬ 
PLES). If the MR to be deleted is currently in the list of MRs, it is removed and 
changed into a “comment” line. A list of all deleted MRs is placed in the comment 
section of the delta commentary and preceded by a comment line stating that they 
were deleted. 

If *-m is not used and the standard input is a terminal, the prompt MRs? is issued on 
the standard output before the standard input is read; if the standard input is not a 
terminal, no prompt is issued. The MRsT prompt always precedes the comments? 
prompt (see -y option). 

MRs in a list are separated by blanks and/or tab characters. An unescaped new-line 
character terminates the MR list. 

Note that if the v flag has a value (see admtn(l)), it is taken to be the name of a pro¬ 
gram (or shell procedure) which validates the correctness of the MR numbers. If a 
non-zero exit status is returned from the MR number validation program, cdc ter¬ 
minates and the delta commentary remains unchanged. 

-y( comment) 

Arbitrary text used to replace the eomment(s) already existing for the delta specified 
by the -p option. The previous comments are kept and preceded by a comment line 
stating that they were changed. A null comment has no effect. 

If —y is not specified and the standard input is a terminal, the prompt comments? is 
issued on the standard output before the standard input is read; if the standard input 
is not a terminal, no prompt is issued. An unescaped new-line character terminates 
the comment text. 
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The exact permissions necessary to modify the SCCS file are documented in Source Code Corttrol 
Syetem. Simply stated, they are either (1) if you made the delta, you can change its delta com* 
mentary; or (2) if you own the file and directory you can modify the delta commentary. 

EXAMPLES 

tutorial% ede -rl.6 -m*bl78-lS345 !bl77-54321 bl70.00001* -ytrouble adlle 
adds bl78>1234S and bl79-00001 to the MR list, removes bI77*54321 from the MR list, and adds 
the comment trouble to delta 1.6 of 8.file. 

tutorial% ede -rl.6 s.flle 
MRS? !bl77-543Sl bl78-13345 bl70-00001 
comments? trouble 
does the same thing. 

WARNINGS 

If SCGS file names are supplied to the ede command via the standard input (— on the command 
line), then the -m and -y options must also be used. 

FILES 

X'file (see de/fa(l)) 

s-file (see de/fejl)) 

SEE ALSO 

admin(l), comb(I), delta(l), fet(l), help(l), prs(l), 8ccs(l), scc8diff(l), sccsfile(5), val(l), what(l). 
Source Code Control Syetem in Programming Toole for the Sun Worketation. 

DIAGNOSTICS 

Use hetp{l) for explanations. 
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NAME 

checknews - check if user has news on the USENET news network 
SYNOPSIS 

eheeknewn ( ynqew ] [ readnewt optiont | 

DESCRIPTION 

ehecknewt reports to the user whether or not there is news. 

OPTIONS 

y Reports ‘There is news’ if the user has news to read, y is the default if no options are 
specified. 

n Reports 'No news’ if there isn’t any news to read. 

q Makes ehecknewt quiet. Instead of displaying a message, the exit status indicates news. A 
status of 0 means no news, 1 means there is news. 

V alters the y message to show the name of the first newsgroup containing unread news. Dou* 
bling V (that is, vv) displays a report of any claim of new news, and is useful if eheeknewn 
and readnewa disagree on whether there is news. 

e Executes readnew8(l) if there is news. 

Ftt-ES 

'/.newsrc Options and list of previously read articles 

/usr/Iib/news/active Active newsgroups 

SEE ALSO 

inews(l), postnew8(l), readnews(l) 

Network Newt Uter't Guide in the Beginner't Guide to the Sun Workttation. 
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NAME 

checknr - check nroff/troff files 
SYNOPSIS 

checknr (-■ ] [ -f ] [ -a jcl.yljc2.y2 ... dCD.yii ] (-c jc1^2jc 3 ... jcn ] (... ] 
DESCRIPTION 

Checknr checks a list of nroJB{l) or tro£f{l) input files for certain kinds of errors involving 
mismatched opening and closing delimiters and unknown commands. If no files are specified, 
eheeknr checks the standard input. Delimiters checked are: 

(1) Font changes using \fx ... \1P. 

(2) Size changes using \ax ... \s0. 

(3) Macros that come in open ... close forms, for example, the .TS and .TE macros which 
must always come in pairs. 

Checknr knows about the ms(7) and me(7) macro packages. 

Checknr is intended to be used on documents that are prepared with eheeknr in mind. It expects 
a certain document writing style for \f and \s commands, in that each \fx must be terminated 
with \1P and each \8x must be terminated with \s0. While it wiU work to directly go into the 
next font or explicitly specify the original font or point size, and many existing documents actu> 
ally do this, such a practice will produce complaints from eheeknr. Since it is probably better to 
use the \fP and \s0 forms anyway, you should think of this as a contribution to your document 
preparation style. 

OPTIONS 

-■ Ignore \s size changes. 

-f Ignore \f font changes. 

-a Add pairs of macros to the list. Thb pairs of macros are assumed to be those (such as J>S 
and .DE) that should be checked for balance. The -a option must be followed by groups 
of six characters, each group defining a pair of macros. The six characters are a period, 
the first macro name, another period, and the second macro name. For example, to 
define a pair .BS and .ES, use -a.BS£S 

-e define commands which eheeknr would otherwise complain about as undefined. 

SEE ALSO 

nroff(l), troff(l), ms(7), me(7), checkeq(l) 

BUGS 

There is no way to define a 1 character macro name using -a 
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NAME 

chgrp - change group 
SYNOPSIS 

ehgrp [ -f ] group file ... 

DESCRIPTION 

Chgrp changes the group>ID of the fUe» to group. The group may be either a decimal GID or a 
group name found in the group-ED file. 

The user invoking ehgrp must belong to the specified group and be the owner of the file, or be the 
super-user. 

No errors are reported when the —f (force) option is given. 

FILES 

/etc/group 
SEE ALSO 

chown(2), pas8wd(5), group(5) 


Q 
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NAME] 

chmod - change mode 

SYNOPSIS 

chmod mode file... 

DESCRIPTION 

The mode of each named file is changed according to mode, which may be absolute or symbolic. 
An absolute mode is an octal number constructed from the OR of the following modes: 

4000 set user ID on execution 
2000 set group ID on execution 
1000 sticky bit, see ehmod{2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

A symbolic mode has the form: 

( who ] op permieoion ( op permieeion |... 

The who part is a combination of the letters u (for user’s permissions), g (group) and o (other). 
The letter a stands for all, or ugo. If who is omitted, the default is a but the setting of the file 
creation mask (see nmask(2)) is taken into account. 

Op can be + to wi^r^^ermieeion to the file’s mode, - to take away permieoion and » to assign 
permieeion absolutely (all other bits for that category, owner, group, or others, will be reset). 

Permieeion is any combination of the letters r (read), w (write), x (execute), ■ (set owner or group 
id) and t (save text - sticky). Letters u» g or o indicate that permieeion is to be taken from the 
current mode. Omitting permieeion is only useful with a to take away all permissions. 

EXAMPLES 

The first example denies write permission to others, the second makes a file executable: 

chmod o-w file 
chmod + X file 

Multiple symbolic modes separated by commas may be given. Operations are performed in the 
order specified. The letter • is only useful with u or g. 

Only the owner of a file (or the super^user) may change its mode. 

SEE ALSO ■ 

Is(l), chmod(2), stat(2), umask(2), chown(8) 
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NAME 

chsh - change default login shell 
SYNOPSIS 

ehsh username [ shell | 


DESCRIPTION 

CAsA change the lopn shell field of the user’s password file entry. If no shell is specified, the shell 
super^usw*^* default login shell /bin/th. To specify a shell other than Ibinjcth, you must be the 


EXAMPLES 

angel% ehsh bill /bln/esh 

SEE ALSO 

C8h(l), passwd(l), paB8wd(5) 
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NAME 

clear - clear workstation or terminal screen 

SYNOPSIS 

elenr 

DESCRIPTION 

Clear clears your screen if this is possible. It looks in the environment for the terminal type and 
then in /eteftermeap to figure out how to clear the screen. 

FILES 

/etc/termcap terminal capability data base 
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NAME 

cmp - compare two files 
SYNOPSIS 

cmp (-!](-■] filel file2 
DESCRIPTION 

Cmp compares fdtl and fileS. If fUel is cmp reads from the standard input. Under default 
options, cmp makes no comment if the files are the same; if they differ, it announces the byte and 
line number at which the difference occurred. If one file is an initial subsequence of the other, 
that fact is noted. 

OPTIONS 

-1 Print the byte number (decimal) and the differing bytes (octal) for each difference. 

-8 Print nothing for differing files; return codes only. 

SEE ALSO 

diff(l), comm(l) 

DIAGNOSTICS 

Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or missing 
argument. 


o 
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NAME 

col - filter reverse paper motions 

SYNOPSIS 

col [ -bfk ] 

DESCRIPTION 

Col copies the standard input to the standard output and perforins line overlays implied by 
reverse line feeds (ESC-7 in ASCII) and by forward and reverse half line feeds (E!SC«9 and ESC-8). 
Cot is particularly useful for filtering multicolumn output made with the '.rt’ command of nroff 
and output resulting from use of the til{l) preprocessor. 

The control characters SO (ASCII code 017), and SI (016) are assumed to start and end text in an 
alternate character set. The character set (primary or alternate) associated with each printing 
character read is remembered; on output, SO and SI characters are generated where necessary to 
maintain the correct treatment of each character. 

All control characters are removed from the input except space, backspace, tab, return, newline, 
PSC (033) followed by one of 7, 8, 9, SI, SO, and VT (013). This last character is an alternate 
form of full reverse line feed, for compatibility with some other hardware conventions. All other 
non-printing characters are ignored. 

OPTIONS 

-f Fine; although eol accepts half line motions in its input, it normally does not emit them 
on output. Instead, text that would appear between lines is moved to the next lower full 
line boundary. The -f option suppresses this treatment — in this case the output from 
eol may contain forward half line feeds (ESC-9), but will still never contain either kind of 
reverse line motion. 

-b Col assumes that the output device in use is not capable of backspacing. In this case, if 
several characters are to appear in the same place, only the last one read will be taken. 

-X Do not convert white space to tabs to shorten printing time. 

SEE ALSIO 

tfoff(l). tbl(l) 

BUGS 

Can’t back up more than 128 lines. 

No more than 800 characters, including backspaces, on a line. 
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NAME 

colcrt - filter nroff output for CRT previewing 
SYNOPSIS 

eolert [ — ] {-2 ] ( file ... ] 

DESCRIPTION 

Coleri provides virtual half-line and reverse line feed sequences for terminals without such capa^ 
bility, and on which overstriking is destructive. Half-line characters and underlining (changed to 
dashing *-’) are placed on new lines in between the normal output lines. 

OPTIONS 

- Suppress all underlining — especially useful for previewing atlboxed tables from (U(l). 

-2 Print all half-lines, effectively double spacing the output. Normally, a minimal space out¬ 

put format is used which suppresses empty lines. Colcrt never suppresses two consecutive 
empty lines, however. The -2 option is useful for sending output to the line printer when 
the output contains superscripts and subscripts which would otherwise be invisible. 

EXAMPLE 

A typical use of colcrt would be 

tbl exum2.n | nroff -ms | colcrt - | more 

SEE ALSO 

nroff(l), troff(l), col(l), more(l), ul(l) 

BUGS 

Should fold underlines onto blanks even with the option so that a true underline character 
would show; if we did this, however, eolert wouldn’t get rid of eu’d underlining completely. 

Can’t back up more than 102 lines. 

General overstriking is lost; as a special case ‘|’ overstruck with or underline becomes ‘-h ’. 
Lines are trimmed to 132 characters. 

Some provision should be made for processing superscripts and subscripts in documents which are 
already double-spaced. 
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NAME 

eolnn - remove columns from a file 
SYNOPSIS 

eolrm ( startcol | endcol ] ] 

DESCRIPTION 

Coirm removes selected columns from a text file. The text is is taken from standard input and 
copied to the standard output with the specified columns removed. 

If only $tarteol is specified, the columns of each line are removed starting with »tarteol and 
extending to the end of the line. If both ttarteol and endeol are specified, aU columns between 
itarteol and endcol, inclusive, are removed. 

Column numbering starts with column 1. 

SEE AUSO 

fxpand(l) 
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NAME 

comb - combine SCCS deltas 
SYNOPSIS 

/usr/secs/eomb (-o ] [ -b ] {-p sid ] (-c list ] file ... 

DESCRIPTION 

Csmb generates a shell procedure (see sA(l)) which, when run, will reconstruct the given SCCS 
files. If a directory is named, comb behaves as though each file in the directory were specified as 
a named file, except that non>SCCS files (last component of the path name does not begin with a.) 
and unreadable files are silently ignored. If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be processed; non-SCCS files 
and unreadable files are silently ignored. The generated shell procedure is written on the stan¬ 
dard output. 

OPTIONS 

Options are explained as though only one named file u to be processed, but the effects of any 
option apply independently to each named file. 

-p SID The 5CCS /Dentification string (SID) of the oldest delta to be preserved. All older deltas 
are discarded in the reconstructed file. 

-clist Aof deltas to be preserved. All other deltas are discarded. See pe((l) for the syntax 
of a list. 

-o For each get -e generated, the reconstructed file is accessed at the release of the delta to 
be created. In the absence of the -o option, the reconstructed file is accessed at the most 
recent ancestor. Use of the -o option may decrease the size of the reconstructed SCCS 
file. It also alter the shape of the delta tree of the original file. 

-a Generate a shell procedure which, when run, will produce a report giving, for each file: 
the file name, size (in blocks) after combining, original size (also in blocks), and percen¬ 
tage change computed by: 

100 * (original - combined) / original 

It is recommended that before any SCCS files are actually combined, you should use this 
option to determine exactly bow much space is saved by the combining process. 

If no options are specified, comb preserves only leaf deltas and the minimal number of ancestors 
needed to preserve the tree. 

FILES 

S.COMB The name of the reconstructed SCCS file, 

combfffff Temporary. 

SEE ALSQ 

8cc8(l), admin(l), delta(l), get(l), help(l), pr8(l), 8ccsfile(5). 

Source Code Control System in Programming Tools for the Sun Workstation. 

DIAGNOSTICS 

Use hetp{l) tor explanations. 

BUGS 

Comb may rearrange the shape of the tree of deltas. It may not save any space; in fact, it is pos¬ 
sible for the reconstructed file to actually be larger than the original. 
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NAME 

comm - select or reject lines common to two sorted files 
SYNOPSIS 

comm I - [ 123 j ] filel file2 
DESCRIPTION 

Comm reads fi/el and /ileS, which should be ordered in ASCII collating sequence, and produces a 
three column output: lines only in filel; lines only in JUeB; and lines in both files. The filename 
means the standard input. 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm -12 prints only the 
lines common to the two files; comm -23 prints only lines in the first file but not in the second; 
comm -128 does nothing. 

SEE ALSO 

cmp(l), diff(l), uniq(l) 


50 


Last change: 15 March 1983 


Sun Release 1.1 





COMPACT(l) 


USER COMMANDS 


COMPACT(l) 


NAM]^ 

compact, uncompact, ccat - compress and uncompress files, and cat them 
SYNOpSIS 

eompact ( filename ... ] 
uncompaet { filename ... | 
ccat I filename ... I 

DESCRIPTION 

Compact compresses the named files using an adaptive Huffman code. If no file names are given, 
the standard input is compacted to the standard output. Compact operates as an on-line algo¬ 
rithm. Each time a byte is read, it is encoded immediately according to the current prefix code. 
This code is an optimal Huffman code for the set of frequencies seen so far. It is unnecessary to 
prepend a decoding tree to the compressed file since the encoder and the decoder start in the same 
state and stay synchronized. Furthermore, compact and uncompact can operate as filters. In par¬ 
ticular: 

i ... { compact I uncompact | ... 

grates as a (very slow) no-op. 

When an sffgument file is given, it is compacted and the resulting file is placed in file.C; file is 
rfmoved. The first two bytes of the compacted file code the fact that the file is compacted. This 
^)>de is used to prohibit recompaction. 

The amount of compression to be expected depends on the type of file being compressed. Typical 
values of compression are: Text (38%), Pascal Source (43%), C Source (36%) and Binary (19%). 
These values are the percentages of file bytes reduced. 

Uncompact restores'^e original file from a file called ^e.<7 which was compressed by compact. If 
no file names are given, the standard input is uncompacted to the standard output. 

Ccat cats the original file from a file compressed by compact, without uncompressing the file. 


FILES 


SEE ALSO 


' compacted file created by compact, removed by uncompact 

Hager, Robert G.,‘yariations on a Theme of Huffman*, I.E.E.E. Transactiono on Information 
eory, vol. IT-24, no. 6, November 1978, pp, 668 - 674. 
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NAME 

cp - copy files 
SYNOPSIS 

ep ( —I ] I —r ] filel file2 
ep ( -I I ( -r ] file ... directory 
DESCRIPTION 

Fitel is copied onto JUeS. The mode and owner of JUeS are preserved if it already existed; the 
mode of the source file is used otherwise. 

In the second form, one or mott filet are copied into the iireetory with their original file-names. 

Cp refuses to copy a file onto itself. 


OPTIONS 

V-l Interactive: prompt the user with the name of the file whenever the copy would overwrite 
an old file. Answering with ’y’ means that cp should go ahead and copy the file. Any 
other answer will prevent ep from overwriting the file. 

Recursive: if any of the source files are directories, ep copies each subtree rooted at that 
name; in this case the destination must be a directory. 


EXAMPLES 

^o make a backup copy of goodies: 

% ep goodies old.goodles 
To copy an entire dbectory hierarchy: 

% cp -r /usr/wendy/sre /usr/wendy/baekup 
However, BEWARE of a recursive copy like this one: 

% ep -r /usr/wendy/sre /usr/wendy/src/backup 
which keeps copying files until it fills the entire file system. 

SEE ALSO 

cat(l), pr|l), mv(l), rcp(lC) 

BUGS \ 

There should be an option to copy timestamps to the new files — for instance, when copying a 
whole hierarchy from one file system to another file system, or when making a backup copy. 
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NAME 

cpio - copy file archives in and out 

SYNOPSIS 

epio -o ( acBvn ] 

epio -! { BedmrtuvOs ] ( patterns ] 
eplo -p (adlmruvs ] directory 
DESCRIPTION 

Cplo -o (copy out) reads the standard input to get a list of pathnames, and then copies those files 
onto the standard output, together with pathname and status information. 

Cplo -1 (copy in) reads the standard input (which is assumed to be the product of a previous 
Cplo -o command), to get a list of files selected by zero or more pallerns as defined in the 
nsune-generating notation of rA(l) or caA(l). In patterna, the metar-characters ?, *, and (...] 
match the slash (/) character. The default for patterns is * (select all files). 

Cplo -p (pass) copies out and in in a single operation. Destination pathnames are interpreted 
relative to the named directory. 

OPTIONS 

a 

B 

d 

c 
r 
t 
u 

V 

1 

m 

e 

8 

EXAMPLES 

To copy the contents of a directory into an archive: 

% 1b I epio -o > /dev/mtO 

To duplicate the olddir directory hierarchy in the newdir directory: 

% ed olddir 

% find • -print | cplo -pdl newdir 

Some forms of epio tapes from other sites have the bytes swapped in the file. The s option 
doesn’t help since it only swaps the data bytes and not the header. To overcome this problem, 
use dd with the conv=swab option to swap aU pairs of bytes (including the header), then pipe 
the output of dd through cpio with the s option to swap the data bytes back again: 

% dd Ifs whatever the file is conv=8wab | cplo -is 


Reset the access times of input files after they have been copied. 

Input/output is to be blocked at 5120 bytes to the record. This does not apply to the 
pass option. This option is only meaningful with data directed to or from /dev/rmt? 

Directories should be created as needed. 

Write header information in ASCII character form for portability. 

Interactively rename files. If the user types a null line, the file is skipped. 

Print a Table of contents of the input. No files are created. 

Copy unconditionally. Normally, an older file will not replace a newer file with the same 
name. 

Verbose option. A list of filenames is displayed. When used with the t option, the table 
of contents looks like the output of an b -1 command (see /s(l)). 

Whenever possible, link files rather than copying them. Usable only with the -p option. 

Retain previous file modification time. This option is ineffective on directories that are 
being copied. 

Process an old (version 6 UNIX system) file. This is only useful with -i (copy in). 

Swaps pairs of data bytes. Note that the a option cannot be used with the c option. 
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SEE ALSO 

ar(l), find(l), cpio(5) 

BUGS 

Pathnames are restricted to 128 characters. If there are too many unique linked files, epio runs 
out of memory to keep track of them and linking information is lost thereafter. Only the super- 
user can copy special files. 
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NAME 

cpp - the C language preprocessor 
SYNOPSIS 

/Ub/cpp I -P -C -Uname —Dnome -Dname=def —Idir ] [ ifile (ofile ] ] 

DESCRIPTION 

Cpp is the C language preprocessor which is invoked as the first pass of any C compilation using 
the cc(l) command. Thus the output of cpp is designed to be in a form acceptable as input to 
the next pass of the C compiler. Use of cpp other than in this framework is not suggested. The 
preferred way to invoke cpp is through the ce(l) command since the functionality of cpp may 
someday be moved elsewhere. See m^(l) for a general macro processor. 

Cpp optionally accepts two file names as arguments. Ijile and cfiie are respectively the input and 
output for the preprocessor. They default to standard input and standard output if not supplied. 

Preprocess the input without producing the line control information used by the next pass 
of the C compiler. 

Pass all comments (except comments which appear on cpp directive lines) through the 
preprocessor. By default, cpp strips C-style comments. 

-Uname 

Remove any initial definition of name, where name is a reserved symbol that is 
predefined by the particular preprocessor. The current list of these possibly reserved sym¬ 
bols includes: 

operating system: ibm, geos, os, tss, unix 

hardware; interdata, pdpll, tt370, u3b, vax, mc68000 

UNIX System variant: RES, RT, SUN 

-Dname 

Define name as 1 (one). This is the same as if a -Dname=l option had appeared on the 
cpp command line, or as if a #deflne name 1 line had appeared in the source file that 
cpp is processing. 

-Dname=def 

Define name as if by a #deflne directive. This is the same as if a #deflne name def 
line had appeared in the source file that cpp is processing. 

-Idtr Change the algorithm for searching for #lnelude files whose names do not begin with / 
to look in dir before looking in the directories on the standard list. Thus, #lnelude files 
whose names are enclosed in ” ” will be searched for first in the directory of the ifile argu¬ 
ment, then in directories named in -I options, and last in directories on a standard list. 
For #lnelude files whose names are enclosed in <>, the directory of the ifile argument 
is not searched. See the section entitled Details of the CPP Preprocessor for exact details 
of the search order. 

-R Allow recursive macros. 

CPP DIRECTIVES 

All cpp directives start with lines begun by #. The directives are: 

#deflne name token-string 

Replace subsequent instances of name with token-string. 

#deflne name( arg, •..» arg) token-string 

Notice that there can be no space between name and the (. Replace subsequent instances 
of name followed by a (, a list of comma separated tokens, and a ) by token-string where 
each occurrence of an arg in the token-string is replaced by the corresponding token in the 
comma separated list. 


OPTION^ 

-C 
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#undef name 

Forget the definition of name (if any) from now on. 

#lnelude ”filename'* 

#lnelttde <filename> 

Include at this point the contents of filename (which is then run through epp). When the 
K.filename'^ notation is used, filename is only searched for in the standard places. See 
the -I option above for more detail. 

#llne integer-contlanl "filename” 

Generate line control information for the next pass of the C compOer. Integer-constant is 
the line number of the next line and filename is the file where it comes from. If 
"filename” is not given, the current file name is unchanged. 

#endlf 

Ends a section of lines begun by a test directive (#lf, #lfdef, or #lftade^. Each test 
directive must have a matching #endlf. 

name 

The lines following will appear in the output if and only if name has been the subject of a 
previous ^l^deflne without being the subject of an intervening #undef. 

#iftadef name 

The lines following will not appear in the output if and only if name has been the subject 
of a previous #deflne without being the subject of an intervening #andef. 

#tf constant-expression 

Lines following will appear in the output if and only if the constant-expression evaluates 
to non-zero. All binary non-assignment C operators, the ft operator, the unary -, !, and ' 
operators are all legal in constant-expression. The precedence of the operators is the 
same as defined by the C language. There is also a unary operator defined, which can be 
used in constant-expression in these two forms: defined ( name ) or defined name. This 
allows the utility of #lfdef and #lftidef in a #lf directive. Only these operators, integer 
constants, and names which are known by cpp should be used in constant-expression. In 
particular, the nlseof operator is not available. 

#ebe Reverses the notion of the test directive which matches this directive. So if lines previous 
tp this directive are ignored, the following lines wUl appear in the output. And vice 
vefsa. 

The test directives and the possible #elte directives can be nested. 

DETAILS OF THE O PREPROCESSOR 

Directory search order for #include files is: 

1. the directory of the file which contains the #include request (that is, #include is relative 
to the file being scanned when the request is made) 

2. the directories specified by the -I option, in left-to-right order. 

3. the standard directory(s) {fuiTfincluie for the Sun system). 

Special Names: Two special names are understood by cpp. The name_,LINE__ is defined as 

the current line number (a decimal integer) as known by epp, and_FILE_is defined as the 

current file name (a C string) as known by cpp. They can be used anywhere (including in macros) 
just as any other defined name. 

An unescaped newline (the single character ”0) terminates a character constant or quoted 
string. 

An escaped newline (the two-character sequence ’’\0) may be used in the body of a ’#define* 
statement to continue the definition onto the next line. The escaped newline is not included in 
the macro body. 
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Comments are uniformly removed (except if the —C option is used on the command line). 
Comments are also ignored, except that a comment terminates a token. Thus 
left/* la di da */right 

may expand ‘left’ and ‘right’ but will never expand ‘leftright’. If neither ‘left’ nor ‘right’ is a 
macro then the output is ‘leftright’, even if ‘leftright’ is defined as something else. The file: 
#define agelimit(a,b)b/**/a 
agelimit(l,2) 

produces ‘21’ because the comment causes a break enabling cpp to recognize ‘b’ and ‘a’ as formals 
in the string ‘b/**/a’. 

Macro format parameters are recognized in ‘^define’ bodies even inside character constants 
and quoted strings. The output from: 

#define foo(a) ” 
foo(bar) 

is the seven characters ” ’\bar”’. Macro names are not recognized inside character constants or 
quoted strings during the regular scan. Thus: 

#deflne foo bar 
printf(’’foo’’); 

does not expand ‘foo’ in the second line, because it is inside a quoted string which is not part of a 
‘#define’ macro definition. 

Macros are not expanded while processing a ‘#define’ or ‘#under. Thus: 

#define foo bletch 
#define bar foo 
#undef foo 
bar 

produces ‘foo’. The token appearing immediately after a ‘#ifder or ‘#ifnder is not expanded (of 
course!). 

Macros are not expanded during the scan which determines the actual parameters to another 
macro call. Thus: 

#define revefse(flr6t,6econd)second first 
#define greeting hello 
reverse(greeting, 

||tdefine greeting goodbye 

produces ‘ goodbye’ (and warns about the redefinition of ‘greeting’). 

Incompatibility. The virgule ’/’ in ‘a=/*b’ is interpreted as the first character of the pair ‘/*’ 
which introduces a comment, rather than as the second character of the divide-and-replace opera¬ 
tor ‘a/’. This incompatibility refiects the recent change in the C language which made ‘a/a^b’ 
the legal way to write such a statement if the meaning ‘z—sj *b’ is intended. 

FILES 

/usr/include standard directory for #lnclude files 

SEE ALSO 

cc(l), m4(l). 

DIAGNOSTICS 

The enor messages produced by epp are intended to be self-explanatory. The line number and 
filename where the error occurred are printed along with the diagnostic. 

NOTES 

When newline characters were found in argument lists for macros to be expanded, previous ver¬ 
sions of cpp put out the newlines as they were found and expanded. The current version of cpp 
replaces these newlines with blanks to alleviate problems that the previous versions had when this 
occurred. 
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NAME 

crypt - encode/decode 

SYNOPSIS 

crypt I password ] 

DESCRIPTION 

Crypt encrypts and decrypts the contents of a file. Crypt reads from the standard input and 
writes on the standard output. The patfword is a key that selects a particular transformation. If 
no pateword is given, crypt demands a key from the terminal and turns off printing while the key 
ifl being typed in. Crypt encrypts and decrypts with the same key: 
ttttorial% crypt key <elesr.flle >encrypted.flle 
tutorial% crypt key <encryptedJlle | pr 
will print the contents of etear.file. 

Files encrypted by crypt are compatible with those treated by the editor e<f(l) in encryption 
mode. 

The security of encrypted files depends on three factors: the fundamental method must be hard 
to solve; direct search of the key space must be infeasible; 'sneak paths’ by which keys or clear¬ 
text can become visible must be minimised. 

Crypt implements a ope-rotor machine designed along the lines of the German Enigma, but with a 
266-element rotor. Methods of attack on such machines are known, but not widely; moreover the 
amount of work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deliberately designed to 
be expensive, that is, to take a substantial fraction of a second to compute. However, if keys are 
restricted to (say) three lower-case letters, then encrypted files can be read by expending only a 
substantial fraction of five minutes of machine time. 

Since the key is an argument to the crypt command, it is potentially visible to users executing 
p«(l) or a derivative. To minimize this possibility, crypt takes care to destroy any record of the 
key immediately upon entry. No doubt the choice of keys and key security are the most vulner¬ 
able aspect of crypt. 

FILES 

/dev/tty for typed key 

SEE ALSO 

ed(l), makekey(8) 

RESTRICTIONS 

This program is not available on software shipped outside the U.S. 
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DESOMfTION 

0h is a command language interpreter which may be used instead of 9A(1), typically to take 
^vantage of its history mechanism (see HMory Suh$titution») and its job control facilities (see 


As instance of csh begins by executing commands from the file .cshrc in the user’s home direc¬ 
tory. If this is a login shell then eah also executes commands from the file .login in the user’s 
heme directory. It is typical for users on crt’s to put the command atty crt in their .login file, 
and call fsei(l) from the .login file as well. 

In the normal case, the shell then begins reading commands from the terminal, prompting with 
'% ’. Processing of arguments and the use of the shell to process files containing command scripts 
is described later. 

The shell then repeatedly performs the following actions: a line of command input is read and 
broken into worde. This sequence of words is placed on the command history list and then 
parsed. Finally each command in the current line is executed. 

When a login shell terminates it executes commands from the file .logout in the users home direc¬ 
tory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs with the following exceptions: The char¬ 
acters ‘I’, ’<’, ’>’, '(’, and ')’ form separate words. If doubled in ‘| j’, ’<<’, or 

’>>’ these pairs form single words. These parser metacharacters may be made part of other 
words, or prevented their special meaning, by preceding them with ‘\’. A newline preceded by a 
‘\’ is equivalent to n blank. 

In addition strings enclosed in matched pairs of quotations, or form parts of a word; 

metacharacters in these strings, including blanks and tabs, do not form separate words. These 
quotations have semantics to be described subsequently. Within pairs of or ”” characters a 
newline preceded by a ‘\’ gives a true newline character. 

When the shell’s input is not a terminsd, the character ’#’ introduces a comment which continues 
to the end of the input line. The character does not introduce a comment when preceded by 
‘\* and in quotations using and 

Commands 

A simple command is a sequence of words, the first of which specifies the command to be exe¬ 
cuted. 

A simple command or a sequence of simple commands separated by ‘|’ (vertical bar) characters 
forms a pipeline. The output of each command in a pipeline is connected to the input of the 
next. Sequences of pipelines may be separated by and are then executed sequentially. A 
sequence of pipelines may be executed without immediately waiting for it to terminate by follow¬ 
ing it with an 

Any of the above may be placed in ’(’ *)’ to form a simple command (which may be a component 
of a pipeline, etc.) It is also possible to separate pipelines with ‘| |’ or ‘&&’ indicating, as in the C 
language, that the second is to be executed only if the first fails or succeeds respectively. (See 
Expreaeiona). 
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Jobs 

The shell associates a job with each pipeline. It keeps a table of current jobs, which you can 
display with the jobs command, and assigns them small integer numbers. When a job is started 
asynchronously with the shell prints a line which looks like: 

[1] 1234 

indicating that this job is job number 1 and has one (top*level) process, whose process id is 1234. 

If you are running a job and wish to do something else you may hit the key *Z (control-Z) which 
sends a STOP signal to the current job. The shell then normally indicates that the job has been 
‘Stopped’, and displays another prompt. You can then manipulate the state of this job, putting it 
in the background with the bg command, or run some other commands and then eventually bring 
the job back into the foreground with the foreground command fg. A “Z takes effect immediately 
and is like an interrupt in that pending output and unread input are discarded when it is typed. 
There is another special key “Y which does not generate a STOP signal untU a program attempts 
to read{2) it. This can usefully be iyped ahead when you have prepared some commands for a 
job which you wish to stop after it has read them. 

A job being run in the background will stop if it tries to read from the terminal. Background 
jobs are normally allowed to produce output, but diis can be disabled by giving the command 
•tty tostop. If you set this tty option, background jobs will stop when they try to produce out¬ 
put like they do when they try to read input. 

There are several ways to refer to jobs in the shell. The character *%’ introduces a job name. If 
you wish to refer to job number 1, you can name it as ‘%1’. Just naming a job brings it to the 
foreground; thus ‘%1’ is a synonym for *fg %V, which brings job 1 back into the foreground. 
Similarly, typing ‘%1 &’ resumes job 1 in the background. Jobs can also be named by prefixes of 
the string typed in to start them, if these prefixes are unambiguous; thus, for example, ‘%ex’ nor¬ 
mally restarts a suspended tx(\) job, if there is only one suspended job whose name begins with 
the string ‘ex’. It is abo possible to use ‘%Tstring’ to specify a job whose text contains tiring, if 
there is only one such job. 

The shell maintains a notion of the current and previous jobs. In output pertaining to jobs, the 
current job u marked with a *-(- ’ and the previous job with a The abbreviation ‘%+ ’ refers 
to the current job and refers to the previous job. For close analogy with the syntax of the 
hitiory mechanism (described below), ’%%’ u also a synonym for the current job. 

Status reporting 

The shell learns immediately whenever a process chmiges state. It normally informs you when¬ 
ever a job becomes blocked so that no further progress u possible, but only just before it prints a 
prompt. This u done so that it does not otherwbe dbturb your work. If, however, you set the 
shell variable notify, the shell will notify you immediately of changes of status in background 
jobs. There is also a shell command notify which marks a single process so that its status changes 
will be immediately reported. By default notify marks the current process; simply say ‘notify’ 
after starting a background job to mark it. 

When you try to leave the shell while jobs are stopped, you win be warned that ‘You have 
stopped jobs.’ You may use the jobs command to see what they are. If you do this or immedi¬ 
ately try to exit again, the sheU wiU not warn you a second time, and the suspended jobs wiU be 
terminated. 

Substliutlons 

We now describe the various transformations the sheU performs on the input in the order in which 
they occur. 
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History substitutions 

History substitutions place words from previous command input as portions of new commands, 
making it easy to repeat commands, repeat arguments of a previous command in the current com¬ 
mand, or fix spelling mistakes in the previous command with little typing and a high degree of 
confidence. History substitutions begin with the character '!’ and may begin anywhere in the 
input stream (with the proviso that they do not nest.) This ‘!’ may be preceded by an ‘\’ to 
prevent its special meaning; for convenience, a '!’ is passed unchanged when it is followed by a 
blank, tab, newline, '=>’ or '(’. History substitutions also occur when an input line begins with 
(circumfiex) — this special abbreviation is described later. Any input line which contains history 
substitution is echo^ on the terminal before it is executed as it could have been typed without 
history substitution. 

Commands input froin the terminal which consist of one or more words are saved on the history 
list, the size of which is controlled by the history variable; the previous command is always 
retained, regardless of its value. The history substitutions reintroduce sequences of words from 
these saved commands into the input stream. Commands are numbered sequentially from 1. 

For definiteness, consider the following output from the history command: 

9 write michael 

10 ex write.c 

11 cat oIdwrite.c 

12 diff*write.c 

The commands are shown with their event numbers. It is not usually necessary to use event 
numbers, but the current event number can be made part of the prompt by placing an '!’ in the 
prompt string. 

With the current event 13 we can refer to previous events by event number ‘111’, relatively as in 
‘1-2* (referring to the same event), by a prefix of a command word as in ‘Id* for event 12 or ‘!wri’ 
for event 0, or by a string contained in a word in the command as in ‘!?mic?’ also referring to 
event 0. These forms, without further modification, simply reintroduce the words of the specified 
events, each separated by a single blank. As a special case '!!’ refers to the previous command; 
thus '!!’ alone is essentially a redo. 

To select words from an event we can follow the event specification by a and a designator for 
the desired words. The words of an input line are numbered from 0, the first (usually command) 
word being 0, the second word (first argument) being 1, etc. The basic word designators are: 

# the entire command line typed so far 

0 first (command) word 

n n’th argument 

* first argument, that is, *1’ 

$ last argument 

% word matched by (immediately preceding) ?s? search 

x-y range of words 

-y abbreviates ‘0-y’ 

• abbreviates or nothing if only 1 word in event 

** abbreviates 'x-f 

X- like ‘x*’ but omitting word *$’ 

The separating the event specification from the word designator can be omitted if the argu¬ 
ment selector begins with a **’, ‘I’, or *%’. After the optional word designator can be 

placed a sequence of modifiers, each preceded by a The following modifiers are defined: 

h Remove a trailing pathname component, leaving the head, 

r Remove a trailing ‘.xxx’ component, leaving the root name, 

e Remove all but the extension ‘.xxx’ part, 

s/f/r/ Substitute r for / 
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t Remove all leading pathname components, leaving the taO. 

& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, for example, ‘g&’. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 

X Like q, but break into w<Hrds at blanks, tabs and newlines. 

Unless preceded by a 'g’ the modification is applied onfy to the first modifiable word. With sub¬ 
stitutions, it is an error for no word to be ]q>plicable. 

Tj^lie left hand side of substitutions are not regular expressions in the sense of the editors, but 
rither strings. Any character may be used as the delimiter in place of '/’> > ‘\’ quotes the delim¬ 
it nr into the / and r strings. The character in the right hand side is replac^ by the text from 
tj e left. A ‘\’ quotes abo. A null I uses the previous string either from a I or from a contex- 
t| gl scan string s in The trailing delimiter in the substitution may be omitted if a newline 
fffllows immediately as may the trailing in a contextual scan. 

^l/hbtory reference may be given without an event specification, for example. Ml’. In thb case 
the reference b to the previous command unless a previous history reference occurred on the same 
line in which case thb form repeats the previous reference. Thus MTfoo?" !$’ gives the first and 
last arguments from the command matching ’ffoo?’. 

A special abbreviation of a history reference occurs when the first non-blank character of an input, 
line is a Thb is equivalent to M:s*’ providing a convenient shorthand for substitutions on the 
text of the previous line. Thus ‘^IbMib’ fixes the spelling of ‘lib’ in the previous command. 
Finally, a hbtory substitution may be surrounded with '{’ and if necessary to insulate it from 
the characters which follow. Thus, after 'b -Id "paul’ we might do '!{I}a’ to do ‘Is -Id ~paula’, 
while ‘ila* would look for a command starting ‘la’. 

Quotntlona with 'and ” 

The quotation of strings by and ‘’” can be used to prevent all or some of the remaining substi¬ 
tutions. Strings enclosed in are prevented any further interpretation. Strings enclosed in ”” 
are yet variable and command expanded as described below. 

In both cases the resulting text becomes (all or part of) a single word; only in one special case (see 
Command Subftitition below) does a ‘’” quot^ string yield parts of more than one word; 
quoted strings never do. 

AUu substitution 

The shell maintains a Qst of aliases which can be establbhed, dbplayed and modified by the alias 
and unalias commands. After a command line is scanned, it b parsed into dbtinct commands and 
the first word of each command, left-to-right, is checked to see if it has an alias. If it does, the 
text which is the alias for that command is reread with the history mechanbm available as 
though that command were the previous input line. The resulting words replace the command 
and argument Ibt. If no reference b made to the history Ibt, the argument Ibt b left unchanged. 

Thus if the aiias for ‘b’ is ‘b -1’ the command ‘Is /usr’ would map to ‘b -1 /usr’, the argument 
Ibt here being undbturbed. Similarly if the alias for ‘lookup’ was ‘grep T /etc/passwd’, ‘lookup 
bill’ would map to ‘grep bill /etc/passwd’. 

If an alias b ifound, the word transformation of the input text b performefl and the aliasing pro¬ 
cess begins again on the reformed input line. Looping is prevented if the first word of the new 
text is the same as theL.oId by fiagging it to prevent further aliasing. Other loops are detected and 
cause an error. 

Note that the mechanbm allows aliases to introduce parser metaqrntax. Thus we can ‘alias print 
*pr \!* I Ipr ” to make a command which pr's its arguments to the line printer. 
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Variable substitution 

The sheli maintains a set of variables, each of which has as value a list of zero or more words. 
Some of these variables are set by the shell or referred to by it. For instance, the arpv variable is 
an image of the shell’s argument list, and words of this variable’s value are referred to in special 
ways. 

The values of variables may be displayed and changed by using the set and unset commands. Of 
the variables referred to by the shell a number are toggles; the shell does not care what their 
value is, only whether they are set or not. For instance, the verbose variable is a toggle which 
causes command input to be echoed. The setting of this variable results from the -v command 
line option. 

Other operations treat variables numerically. The command permits numeric calculations to 
be performed and the result assigned to a variable. Variable values are, however, always 
represented as (zero or more) strings. For the purposes of numeric operations, the null string is 
considered to be zero, and the second and subsequent words of multiword values are ignored. 

After the input line is aliased and parsed, and before each command is executed, variable substi¬ 
tution is performed keyed by *1’ characters. This expansion can be prevented by preceding the 
with a '\’ except within ””s where it always occurs, and within ‘'’s where it never occurs. 
Strings quoted by are interpreted later (see Command substitution below) so substitution 
does not occur there until later, if at all. A is passed unchanged if followed by a blank, tab, or 
end-of-line. 

Input/output redirections are recognized before variable expansion, and are variable expanded 
separately. Otherwise, the command name and entire argument list are expanded together. It is 
thus possible for the first (command) word to this point to generate more than one word, the first 
of which becomes the command name, and the rest of which become arguments. 

Unless enclosed in ”” or given the ‘:q’ modifier the results of variable substitution may eventually 
be command and filename substituted. Within ”” a variable whose value consists of multiple 
words expands to a (portion of) a single word, with the words of the variables value separated by 
blanks. When the ‘:q’ modifier is applied to a substitution the variable expands to multiple words 
with each word separated by a blank and quoted to prevent later command or filename substitu¬ 
tion. 

The following metasequences are provided for introducing variable values into the shell input. 
Except as noted, it is an error to reference a variable which is not set. 

$name 
I (name) 

Are replaced by the words of the value of variable name, each separated by a blank. Braces 
insulate name from following characters which would otherwise be part of it. Shell variables 
have names consisting of up to 20 letters and digits starting with a letter. The underscore 
character is considered a letter. 

If name is not a shell variable, but is set in the environment, that value is returned (but t 
modifiers and the other forms given below are not available in this case). 

$name[seIectorj 
$ {name[selector]} 

Mby be used to select only some of the words from the value of name. The selector is sub¬ 
jected to substitution and may consist of a single number or two numbers separated by a 
The first word of a variables value is numbered ‘1’. If the first number of a range is 
omitted it defaults to ‘1’. If the last member of a range is omitted it defaults to ‘$#name’. 
The selector selects aJl words. It is not an error for a range to be empty if the second 
argument is omitted or in range. 


Sun Release 1.1 


Last change: 13 March 1984 


63 






CSH(l) 


USER COMMANDS 


CSH(l) 


$#naine 

|{#name} 

Gives the number of words in the variable. This is useful for later use in a ‘[selector]’. 

$0 

Substitutes the name of the file from which command input is being read. An error occurs 
if the name is not known. 

Inumber 
I {number} 

Equivalent to ‘largvjnumberj’. 

$* 

Equivalent to ‘$argv(*|’. 

The modifiers ‘:h’, ‘:t’, ‘:r’, ‘:q’ and ‘:x’ may be sqxplied to the substitutions above as may ‘:gh’, 
‘:gt’ and ':gr’. If braces '{’ appear in the command form then the modifiers must appear 
within the braces. 

The current implementation allows only one *t' modifier on each '$* expansion. 

The following substitutions may not be modified with modifiers. 

iTname 

|{fname} 

Substitutes the string *1’ if name is set, ‘0’ if it is not. 

IW) 

Substitutes ‘1’ if the current input filename is known, *0’ if it is not. 

$1 

Substitute the (decimal) process number of the (parent) shell. 

$< 

Substitutes a line from the standard input, with no further interpretation thereafter. It can 
be used to read from the keyboard in a shell script. 

Command and filename substitution 

The remaining substitutions, command and filename substitution, are applied selectively to the 
arguments of builtin commands. This means that portions of expressions which are not evaluated 
are not subjected to these expansions. For commands which are not internal to the shell, the 
command name is substituted separately from the argument list. This occurs very late, after 
input-output redirection is performed, and in a child of the main shell. 

Command substitution 

Command substitution is indicated by a command enclosed in The output from such a com¬ 
mand is normally broken into separate words at blanks, tabs and newlines, with null words being 
discarded, this text then replacing the original string. Within '"’s, only newlines force new words; 
blanks and tabs are preserved. 

In any case, the single final newline does not force a new word. Note that it is thus possible for a 
command substitution to yield only part of a word, even if the command outputs a complete line. 

Filename substitution 

If a word contains any of the characters ‘(’ or or begins with the character that 

word is a candidate for filename substitution, also known as ‘globbing’. This word is then 
regarded as a pattern, and replaced with an alphabetically sorted list of file names which match 
the pattern. In a list of words specifying filename substitution it is an error for no pattern to 
match an existing file name, but it is not required for each pattern to match. Only the metachar¬ 
acters '?’ and ‘C imply pattern matching, the characters and '{’ being more akin to abbre¬ 
viations. 
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In matching filenames, the character at the beginning of a filename or immediately following a 
7’, as well as the character 7’ must be matched explicitly. The character matches any string 
of characters, including the null string. The character ‘V matches any single character. The 
sequence '(...]’ matches any one of the characters enclosed. Within a pair of characters 

separated by matches any character lexically between the two. 

The character at the beginning of a filename is used to refer to home directories. Standing 
alone — that is, — it expands to the invoker’s home directory as reflected in the value of the 
variable home. When followed by a name consisting of letters, digits and characters the shell 
searches for a user with that name and substitutes their home directory; thus ‘~ken’ might 
expand to 7usr/ken’ and ‘"ken/chmach’ to 7usf/ken/chmach’. If the character is followed by 
a character other than a letter or or appears not at the beginning of a word, it is left undis¬ 
turbed. 

The metanotation ‘a{b,c,d}e’ is a shorthand for 'abe ace ade'. Left to right order is preserved, 
with results of matches being sorted separately at a low level to preserve this order. This con¬ 
struct may be nested. Thus *~source/sl/{oldls,ls}.c’ expands to ‘/ust/soMTce/sl/oldls.c 
/usr/source/sl/b.c’ whether or not these files exist without any chance of error if the home direc¬ 
tory for ‘source’ is ‘/usr/source’. Similarly ‘../{memo,*box}’ might expand to ‘../memo ../box 
../mbox’. (Note that ‘memo’ was not sorted with the results of matching ‘*box’.) As a special 
case ‘}’ and ‘{}’ are passed undisturbed. 

Input/output 

The standard input and standard output of a commmtd may be redirected with the following syn¬ 
tax: 

^ name 

Open file name (which is first variable, command and filename expanded) as the standard 
input. 

< < word 

Read the shell input up to a line which is identical to word. Word is not subjected to vari¬ 
able, filename or command substitution, and each input line is compared to word before any 
substitutions are done on this input line. Unless a quoting ‘\’, or appears in word 

variable and command substitution is performed on the intervening lines, allowing ‘\’ to 
quote ‘I’, ‘\’ and Commands which are substituted have all blanks, tabs, and newlines 
preserved, except for the final newline which is dropped. The resultant text is placed in an 
anonymous temporary file which is given to the commmid as standard input. 

> name 
>! name 
>ft name 
>&! nmne 

The file name b used as standard output. If the file does not exist, it is created. If the file 
exists, it is truncated; its previous contents are lost. 

If the wiable noclobber is set, the file must not exist or be a character special file (for 
example, a terminal or '/dev/null’) or an error results. This helps prevent accidental des¬ 
truction of files. In this case the ‘I’ forms can be used and suppress this check. 

The forms involving route the diagnostic output into the specified file as well as the 
standard output. Name is expanded in the same way as '<’ input filenames are. 

>> name 

> >& name 
>>! name 
>>&!name 

Uses file name as standard output like '>’ but places output at the end of the file. If the 
variable noelobbet is set, it is an error for the file not to exist unless one of the '!’ forms is 
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given. Otherwise similar to 

A command receives the environment in which the shell was invoked as modified by the input- 
output parameters and the presence of the command in a pipeline. Thus, unlike some previous 
shells, commands run from a file of shell commands have no access to the text of the commands 
by default; rather they receive the original standard input of the shell. The *<<’ mechanism 
should be used to present inline data. This permits shell command scripts to function as cona- 
ponents of pipelines and allows the shell to block read its input. Note that the default standard 
input for a command run detached is not modified to be the empty file '/dtv/nnlV; rather the 
standard input remains as the original standard input of the shell. If this is a terminal and if the 
process attempts to read from the terminal, the process blocks and the user is notified (see Jobs 
above.) 

Diagnostic output may be directed through a pipe with the standard output. Simply use the form 
'I &' rather than just ‘|’. 

Expressions 

A number of the builtin commands (to be described subsequently) take expressions, in which the 
operators are similar to those of C, with the same precedence. These expressions appear in the O, 
exit, if, and while commands. The following operators are available: 

II && I * & — r <->-<>«»+-•/%!“( ) 

Here the precedence increases to the right, *!»»’ and T’, ‘<=»’ *>■■’ *<’ and *>’, 

'<<’ and *>>’, '+ ’ and 7’ being, in groups, at the same level. The *==»’ '!=' 

‘•v*’ and ‘l~’ operators compare their arguments as strings; all others operate on numbers. The 
operators and are like and except that the right hand side is a pattern (con¬ 
taining, for example, ‘*'s, 'f's and instances of ‘|...]’) against which the left hand operand is 
matched. This reduces the need for use of the twitch statement in shell scripts when ^ that is 
really needed is pattern matching. 

Strings which begin with ‘0’ are considered octal numbers. Null or missing arguments are con¬ 
sidered ‘0*. The result of all expressions are strings, which represent decimal numbers. It is 
important to note that no two components of an expression can appear in the same word; except 
when adjacent to components of expressions which are syntactically significant to the parser (‘&’ 
‘I’ ‘<’ *>’ ‘C ')’) they should be surrounded by spaces. Variables whose names appear in expres¬ 
sions must have iheir names preceded by a dollar (I) sign, for example: 

O grab ■■ Igrab-I* i 

Also available in expressions as primitive operands are command executions enclosed in 
and file enquiries of the form name’ where / is one of: 


r read access 

w write access 

X execute access 

e existence 

o ownership 

z zero size 

f plain file 

d directory 


The specified name is command and filename expanded and then tested to see if it has the 
specified relationship to the real user. If the file does not exist or is inaccessible then all enquiries 
return false, that is, ‘O’. Command executions succeed, returning true, that is, if the com¬ 

mand exits with status 0, otherwise they fail, returning false, that is, ‘O’. If more detailed status 
information is required, the command should be executed outside of an expression and the vari¬ 
able status examined. 
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Control flow 

The shell contains a number of commands which can be used to regulate the flow of control in 
command files (shell scripts) and (in limited but useful ways) from terminal input. These com¬ 
mands all operate by forcing the shell to reread or skip in its input and, due to the implementa¬ 
tion, restrict the placement of some of the commands. 

The foreaeh, switch, and while statements, as well as the if-then-else form of the if statement 
require that the major keywords appear in a single simple command on an input line as shown 
below. • 

If the shell’s input is not seekable, the shell buffers up input whenever a loop is being read and 
performs seeks in this internal buffer to accomplish the rereading implied by the loop. (To the 
extent that this allows, backward goto’s will succeed on non-seekable inputs.) 

BuUtln commands 

Builtin commands are executed within the shell. If a builtin command occurs as any component 
of a pipeline except the last, it is executed in a subshell. 

alias 

alias name 
alias nsune wordlist 

The first form prints all aliases. The second form prints the alias for name. The final form 
assigns the specified wordlist as the alias of name; worHist is command and filename substi¬ 
tuted. Same is not allowed to be alias or unalias. Putting single quote signs (apostrophes) 
around wordlist and placing a \ character in front of any ’!’ signs in wordlist often solves 
any obscure problems with aliases. 

mlloe 

Shows the amount of dynamic core in use, broken down into used and free core, and address 
of the last location in the heap. With an argument shows each used and free block on the 
internal dynamic memory chain indicating its address, size, and whether it is used or free. 
This is a debugging command and may not work in production versions of the shell; it 
requires a modified version of the system memory allocator. 

bs 

bu %job... 

Puts the current or specified jobs into the background, continuing them if they were 
stopped. 

break 

Causes execution to resume after the end of the nearest enclosing foreaeh or while. The 
remaining commands on the current line are executed. Multi-level breaks are thus possible 
by writing them all on one line. 

breakaw 

Causes a break from a switch, resuming after the endsw. 
eaae label: 

A label in a switch statement as discussed below, 
ed 

ed name 
ehdlr 

ehdir name 

Change the shell’s working directory to directory name. If no argument is given, change to 
the home directory of the user. 

If name is not found as a subdirectory of the current directory (and does not begin with '/', 
*./’ or *../’), each component of the variable cdpath is checked to see if it has a subdirectory 
name. Finally, if all else fails but name is a shell variable whose value begins with ‘/’i I'his 
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is tried to see if it is a directoiy. 
continue 

Continue execution of the nearest enclosing whUt or for each. The rest of tiie commands on 
the current line are executed. 

defauKf 

Labels the default ease in a switch statement. The default should come after all ease labek. 

dlrs 

Prints the directory stack; the top of the stack is at the left, the first directory in the stack 
being the current directory. 

echo wordlist 
echo -n wordlist 

The specified words are written to the shell’s standard output, separated by spaces, and tei^ 
minated with a newline unless the -n option is specified. 

else 

end 

endlf 

endaw 

See the description of the foreaeh, if, swUek, and white statements below, 
evnlarg... 

(As in rk(l).) The arguments are read as input to the shell and the resulting command(s) 
executed. This is usually used to execute commands generated as the result of command or 
variable substitution, since parsing occurs before these substitutions. See tsef(l) for an 
example of using eval. 

exne command 

The specified command is executed in place of the current shell. 

«xH 

•xlt(expr) 

The shell exits either with the value of tiie status variable (first form) or with the value of 
the specified erpr (second form). 

fg %job... 

Brings the current or specified jobs into the foreground, continuing them if they were 
stopped. 

forcneh name (wordlist) 


end 

The variable name is successively set to each member of wordlist and the sequence of com* 
mands between this command and the matching end are executed. (Both foreaeh and end 
must appear alone on separate lines.) 

The builtin command continue may be used to continue the loop prematurely and the buit 
tin command break to terminate it prematurely. When this command is read from the ter¬ 
minal, the loop is read up once prompting with '?’ before any statements in the loop are 
executed. If you make a mistake typing in a loop at the terminal you can rob it out. 

glfib wordlist 

Like ecAo but no escapes are recognized and words are delimited by null characters in. 
the output. Useful for programs which wish to use the shell to filename «cpand a list of 
words. 
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goto word 

The specified word is filename and command expanded to yield a string of the form ‘label’. 
The shell rewinds its input as much as possible and searches for a line of the form ‘label:’ 
possibly preceded by blanks or tabs. Execution continues after the specified line. 

h&shstat 

Print a statistics line indicating how effective the internal hash table has been at locating 
commands (and avoiding exec's). An exec is attempted for each component of the path 
where the hash function indicates a possible hit, and in each component which does not 
begin with a ‘/’. 

history 
history n 
hbtory -r ti 
history -h n 

Displays the history event list; if n is given only the n most recent events are printed. The 
-r option reverses the order of printout to be most recent first rather than oldest first. The 
•>h option causes the history list to be printed without leading numbers. This is used to 
produce files suitable for sourceing using the -h option to source. 

If (expr) command 

If the specified expression evaluates true, the single command with arguments is executed. 
Variable substitution on command happens early, at the same time it does for the rest of the 
if command. Command must be a simple command, not a pipeline, a command list, or a 
parenthesized command list. Input/output redirection occurs even if expr is false, when 
command is nob executed (this is a bug). 

if (expr) then 
elae if (expr2) then 
else 
endif 

If the specified expr is true, the commands to the first else are executed; else if exprB is true, 
the commands to the second else are executed, etc. Any number of e/se-t/pairs are possible; 
only one endif is needed. The else part is likewise optional. (The words else and endif must 
appear at the beginning of input lines; the if must appear alone on its input line or after an 
else.) 

Jobs 
Jobs -1 

Lists the active jobs; given the -1 options lists process id’s in addition to the normal infor¬ 
mation. 

kUl %iob 

kill -sig %job... 

klUpid 

kill -sig pid ... 
klU-l 

Sends either the TERM (terminate) signal or the specified signal to the specified jobs or 
processes. Signals are either given by number or by names (as given in 
f uerf include!signal.h, stripped of the prefix “SIG”). The signal names are listed by “kill 
-1”. There is no default, saying just ‘kill’ does not send a signal to the current job. If the 
signal being sent is TERM (terminate) or HUP (hangup), then the job or process is sent a 
CONT (continue) signal as well. 
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limit 

limit resource 

limit resource maximum-use 

Limits the consumption by the current process and each process it creates to not individu¬ 
ally exceed maximum-use on the specified resource. If no maximum-use is given, the current 
limit is printed; if no resource is given, all limitations are given. 

Resources controllable currently include eputime (the maximum number of cpu-seconds to 
be used by each process), JUesize (the largest single file which can be created), datasize (the 
maximum growth of the data+stack region via sbrk{2) beyond the end of the program 
text), stacksize (the maximum size of the automaticaUy-extended stack region), and 
eoredumpsize (the size of the largest core dump that will be created). 

The maximum-use may be given as a (floating point or integer) number followed by a scale 
factor. For all limits other than eputime the default scale is ‘k’ or ‘kilobytes’ (1024 bytes); a 
scale factor of ‘m’ or 'megabytes’ may also be used. For eputime the default scaling is 
‘seconds’, while ‘in’ for minutes or ‘h’ for hours, or a time of the form ‘mm;ss’ giving 
minutes and seconds may be used. 

For both resource names and scale factors, unambiguous prefixes of the names suffice. 

login 

Terminate a login sheH, replacing it with an instance of /bln/login. This is one way to log 
off, included for compatibility with «h(l). 

logout 

Terminate a login shell. Especially useful if ignoreeofia set. 

nice 

nice + number 
nice command 
nice + number command 

The first form sets the nice tor this shell to 4. The second form sets the nice to the given 
number. The final two forms run command at priority 4 and number respectively. The 
super-user may specify negative niceness by using ‘nice -number ...’. Command is always 
executed in a sub-shell, and the restrictions placed on commands in simple if statements 
apply. 

nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be ignored for the remainder 
of the script. The second form causes the specified command to be run with hangups 
ignored. All processes detached with are effectively nohup’ed. 

notify 

notify %job ... 

Causes the shell to notify the user asynchronously when the status of the current or 
specified jobs changes; normally notification is presented before a prompt. This is automatic 
if the shell variable notify is set. 

onlntr 
onintr - 
onintr label 

Control the action of the shell on interrupts. The first form restores the default action of 
the shell on interrupts (terminates shell scripts and returns to the terminal command input 
level). The second form ‘onintr -’ causes all interrupts to be ignored. The final form causes 
the shell to execute a ‘goto label’ when an interrupt is received or a child process terminates 
because it was interrupted. 

In any case, if the shell is running detached and interrupts are being ignored, all forms of 
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onintr have no meaning and interrupts continue to be ignored by the shell and all invoked 
commands. 

popd 
popd -bn 

Pops the directory stack, returning to the new top directory. With an argument ‘+ n’ dis* 
cards the nth entry in the stack. The elements of the directory stack are numbered from 0 
starting at the top. 

pushd 
pushd name 
pushd + n 

With no arguments, puehd exchanges the top two elements of the directory stack. Given a 
name argument, puehd changes to the new directory (as in ed) and pushes the old current 
working directory (as in caw) onto the directory stack. With a numeric argument, rotates 
the nth argument of the directory stack around to be the top element and changes to it. 
The members of the directory stack are numbered from the top starting at 0. 

rehash 

Causes the internal hash table of the contents of the directories in the path variable to be 
recomputed. This is needed if new commands are added to directories in the path while you 
are logged in. This should only be necessary if you add commands to one of your own 
directories, or if a ^sterns programmer changes the contents of one of the system direc¬ 
tories. 

repeat count command 

The specified command which is subject to the same restrictions as the command in the one 
line if statement above, is executed count times. I/O redirections occur exactly once, even 
if count is 0. 

set 

set name 
set namesword 
set namejisdexjsword 
set name<B(wordlbt) 

The first form of the command shows the value of all shell variables. Variables which have 
other than a single word as value print as a parenthesized word list. The second form sets 
name to the null string. The third form sets name to the single word. The fourth form sets 
the index'th con^ponent of name to word; this component must already exist. The final 
form sets name to the list of words in wordliat. In all cases the value is command and 
filename expanded. 

These arguments may be repeated to set multiple values in a single set command. Note 
however, that variable expansion happens for all arguments before any setting occurs. 

setenv name value 

Sets the value of environment variable name to be value, a single string. The most com- 
monb^ used environment variables, USER, TERM, and PATH, are automatically imported 
to and exported from the cah variables user, term, and path; there is no need to use aetenv 
for these. 

shift 

shift variable 

The members of argv are shifted to the left, discarding argvflj. It is an error for argv not to 
be set or to have less than one word as value. The second form performs the same function 
on the specified variable. 
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■ouree name 
source -h name 

The shell reads commands from name. Source commands may be nested; if they are nested 
too deeply the shell may run out of file descriptors. An error in a source at any level ter^ 
minates all nested source commands. Normally, input during source commands is not 
placed on the history list; the -b option causes the commands to be placed in the history list 
without being executed. 

stop 

stop %ioh ... 

Stops the current or specified job which is executing in the background. 

suspend 

Causes the shell to stop in its tracks, much as if it had been sent a stop signal with “Z. 
This is most often used to stop shells started by «u(l). 

switch (string) 
case strl: 

breaksw 

defauitt 

breaksw 

endsw 

Each case label is successively matched, against the specified etring which is first command 
and filename expanded. The file metacharacters **’, ‘V and ‘(...]’ may be used in the case 
labels, which are variable expanded. If none of the labels match before a ‘default’ label is 
found, execution begins after the default label. Each case label and the default label must 
appear at the beginning of a line. The command breakew causes execution to continue after 
the endew. Otherwise control may fall throuf^ case labels and default labels as in C. If no 
label matches and there is no default, execution continues after the endew. 

time 

time command 

With no argument, a summary of time used by this shell and its chUdren is printed. If 
arguments are given the specified simple command is timed and a time summary as 
described under the time variable is printed. If necessary, an extra shell is created to print 
the time statistic when the command completes. 

umask 
umask value 

The file creation mask is displayed (first form) or set to the specified value (second form). 
The mask is given in octal. Common values for the mask are 002 giving all access to the 
group and read and execute access to others or 022 giving all access except no write access 
for users in the group or others. 

unaliaa pattern 

All aliases whose names match the specified pattern are discarded. Thus all aliases are 
removed by ‘unalias It is not an error for nothing to be unaliaeed. 

unhash 

Use of the internal hash table to speed location of executed programs is disabled. 

unllmit resource 
unlimit 

Removes the limitation on resource. If no resource is specified, all resource limitations are 
removed. 
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unset pattern 

All variables whose names match the specified pattern are removed. Thus all variables are 
removed by ‘unset this has noticeably distasteful side-effects. It is not an error for noth¬ 
ing to be umet. 

unsetenv pattern 

Removes all variables whose name match the specified pattern from the environment. See 
also the setenv command above and printenv{l). 

wait 

All background jobs are waited for. It the shell is interactive, an interrupt can disrupt the 
wait, at which time the shell prints names and job numbers of all jobs known to be out¬ 
standing. 

while (expr) 
end 

While the specified expression evaluates non-zero, the commands between the while and the 
matching end are evaluated. Break and continue may be used to terminate or continue the 
loop prematurely. (The while and end must appear alone on their input lines.) Prompting 
occurs here the first time through the loop as for the foreach statement if the source of input 
is a terminal. 

%ioh 

Brings the specified job into the foreground. 

%job & 

Continues the specified job in the background. 

A 

<1 name s expr 
O namejindex] » «xpr 

The first form prints the values of all the shell variables. The second form sets the specified 
name to the value of expr. If the expression contains '<’, *>’, or ‘|’ then at least this 
part of the expression roust, be placed within ‘(’ ')’. The third form assigns the value of expr 
to the iniexHh argument of name. Both name and its index’th component must already 
exist. 

The operators '+ =*> etc are available as in C. The space separating the name from 
the assignment operator is optional. Spaces are, however, mandatory in separating com¬ 
ponents of expr which would otherwise be single words. 

Special postfix ‘■f + ’ and ‘—’ operators increment and decrement name respectively, that is, 
'O 1+ + ’. 

Note that there must be a space after the 'Q' sign. 

Pre-deflned and environment variables 

The following variables have special meaning to the shell. Of these, argv, ewd, home, path, 
prompt, ehell and etatue are always set by the shell. Except for ewd and statue this setting occurs 
only at initialization; these variables will not then be modified unless this is done explicitly by the 
user. 

This shell copies the environment variable USER into the variable user, TERM into term, and 
HOME into home, and' copies these back into the environment whenever the normal shell vari¬ 
ables are reset. The environment variable PATH is similarly handled; it is only necessary to 
worry about its setting in the file .eshrc, as inferior csA processes will import the definition of path 
from the environment, and re-export it if you then change it. It could be set once in the .login 
except that commands through the network would not see the definition. 

argv Set to the arguments to the shell. Positional parameters are substituted from 
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edpath 

ewd 

echo 

hietehare 

history 

home 

Ignoreeof 

mall 


noclobber 

noglob 

nonomatch 

notify 

path 


this variable: ‘$1’ is replaced by ‘$argv[l|’, etc. 

Gives a list of alternate directories searched to find subdirectories in ehdir com¬ 
mands. 

The full pathname of the current directory. 

Set when the -x command line option is given. Causes each command and its 
arguments to be echoed just before execution. For non-builtin commands aU 
expansions occur before echoing. Builtin commands sue echoed before command 
and filename substitution, since these substitutions are then done selectively. 

Can be given a string value to change the characters used in history substitution. 
The first character of its value is used as the history substitution character, 
replacing the default character !. The second character of its value replsices the 
character t in quick substitutions. 

Can be given a numeric value to control the size of the history list. Any conr- 
mand which has been referenced in this many events wUl not be discarded. If 
you use an overly-large value for history, the sheU may run out of memory. The 
last executed command is always saved on the history list. 

The home directory of the invoker, initialized from the environment. The 
filename expansion of refers to this variable. 

If set, the shell ignores end-of-file signals from terminals. This prevents shells 
from being accidentally killed by control-D’s. 

The files where the shell checks for mail. This is done after each command com¬ 
pletion which will result in a prompt, if a specified interval has elapsed. The 
shell says ‘You have new mail* if the file exists with an access time not greater 
than its modify time. 

If the first word of the value of mat’/is numeric it specifies a different mail check¬ 
ing interval, in seconds, than the default, which is 5 minutes. 

If multiple mail files are specified, the shell says ‘New mail in name’ when there 
is mail in the file name. 

As described in the section on Input/output, restrictions are placed on output 
redirection to insure that files are not accidentally destroyed, and that ‘>>’ 
redirections refer to existing files. 

If set, filename expansion is inhibited. This is most useful in shell scripts which 
are not dealing with filenames, or after a list of filenames has been obtained and 
further expansions are not desirable. 

If set, it is not an error for a filename expansion to not match any existing files; 
rather the primitive pattern is returned. It is still an error for the primitive pat¬ 
tern to be malformed, that is, ‘echo [’ still gives an error. 

If set, the shell notifies asynchronously of job completions. The default is to 
rather present job completions just before printing a prompt. 

Bach word of the path variable specifies a directory in which commands are to 
be sought for execution. A null word specifies the current directory. If there is 
no path vaoriable, only full path names will execute. The usual search path is 
‘/bin’ and ‘/usr/bin’, but this may vary from system to ^stem. For the super- 
user the default search path is ‘/etc’, ‘/bin’ and ‘/usr/bin’. A shell which is 
given neither the -e nor the -t option will normally hash the contents of the 
directories in the path variable after reading .eshre, and each time the path vari¬ 
able is reset. If new commands are added to these directories while the shell is 
active, it may be necessary to give the rehash or the commands may not be 
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prompt 


savehbt 


^ shell 


status 


time 


verbose 


found. 

The string which is printed before each command is read from an interactive ter¬ 
minal input. If a appears in the string it is replaced by the current event 
number unless a preceding ‘\* is given. Default is *% \ or *# * for the super- 
user. 

is given a numeric value to control the number of entries of the history list that 
are saved in ''/.history when the user logs out. Any command which has been 
referenced in this many events will be saved. During start up the shell sources 
'^/.history into the history list enabling history to be saved across logins. 
Overly-large values of eavehiai will slow down the shell during start up. 

The file in which the shell resides. This is used in forking shells to interpret files 
which have execute bits set, but which are not executable by the system, (See 
the description of Non-buiUin Command Execution below.) Initialized to the 
(^stem-dependent) home of the shell. 

The status returned by the last command. If it terminated abnormally, then 
0200 is added to the status. Builtin commands which fail return exit status 
all other builtin commands set status *0’. 

Controls automatic timing of commands. The time variable can be supplied 
with one or two values, such as ‘set time=3* or ‘set time—(3 ”%%E 
^/usr/src/man/manl/SCCS/s.csh.l^”)*. The first value is a number — n for 
instance. The shell displays a resource-usage summary for any command run¬ 
ning for more than n CPU seconds. The second value is optional and is a char¬ 
acter string which determines which resources the user wishes displayed. The 
character string can be any string of text with embedded control key-letters in 
it. A control key-letter is a percent sign {%) followed by a single upper-case 
letter. To print a percent sign, use two percent signs in a row. Unrecognized 
key-letters arc simply printed. The control key-letters are: 

D Average amount of unshared data space used in Kilobytes. 

E Elapsed (wallclock) time for the command. 

F Page faults. 

I Number of block input operations. 

K Average amount of unshared stack space used in Kilobytes. 

M Maximum real memory used during execution of the process. 

O Number of block output operations. 

P Total CPU time — U (user) plus S (system) — as a percentage of E 
(elapsed) time. 

S Number of seconds of CPU time consumed by the kernel on behalf of 
the user’s process. 

U Number of seconds of CPU time devoted to the user’s process. 

W Number of swaps. 

X Average amount of shared memory used in Kilobytes. 

The default resource-usage summary is a line of the form: 
uuti.uu 88s,ss ee:ee pp% xxx-h dddk iti-h oooio mmmpf+ www 

where uuu.u is the user time (U), 888,8 is the system time (S), ee:ee is the elapsed 
time (E), pp Is the percentage of CPU time versus elapsed time (P), xxx is the 
average shared memory in Kilobytes (X), ddd is the average unshared data space 
in Kilobytes (D), m and ooo are the number of block input and output operap 
tions respectively (I and O), mmm is the number of page faults (F), and ww is 
the number of swaps (W). 

Set by the —v command line option, causes the words of each command to be 
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printed after history substitution. 

NoD'buUtln command execution 

When a command to be executed is found to not be a builtin command the shell attempts to exe* 
cute the command via execve{2). Each word in the variable path names a directory from which 
the shell will attempt to execute the command. If it is given neither a -c nor a -t option, the 
shell hashes the names in these directories into an internal table so that it will only try an exec in 
a directory if there is a possibility that the command resides there. This greatly speeds command 
location when a large number of directories are present in the search path. If this mechanism has 
been turned off (via unhaeh), or if the shell was given a -c or -t argument, and in any case for 
each directory component of path which does not begin with a '/*> shell concatenates with the 
given command name to form a path name of a file which it then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus '(cd ; pwd) ; pwd’ prints the 
home directory; leaving you where you were (printing this after the home directory), while ‘cd ; 
pwd’ leaves you in the home directory. Parenthesized commands are most often used to prevent 
chdir from affecting the current shell. 

If the file has execute permissions but is not an executable binary to the qrstem, it is assumed to 
be a file containing shell commands and a new shell is spawned to read it. 

If there is an aliat for thell then the words of the alias are prepended to the argument list to form 
the sheU command. The first word of the aliao should 1 m the full path name of the shell (for 
example, ‘Ishell’). Note that this is a special, late occurring, case of alias substitution, and only 
allows words to be prepended to the argument list without modification. 

Argument Ust processing 

If argument 0 to the shell is then this is a login sheU. The flag arguments are interpreted as 
follows: 

-e Commands are read from the (single) following argument which must be present. Any 
remaining arguments are placed in argv. 

-• The shell exits if any invoked command terminates abnormally or yields a non>zero exit 
status. 

-f The shell will start faster, because it will neither search for nor execute commands from the 
file ‘.cshrc* in the invokers home directory. 

-I The shell is interactive and prompts for its top>level input, even if it appears to not be a 
terminal. Shells are interactive without this option if their inputs and outputs are termi* 
nals. 

-n Commands are parsed, but not executed. This may aid in syntactic checking of shell 
scripts. 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. A ‘\' may be used to escape the newline at the 
end of this line and continue onto another line. 

-V Sets the verbose variable, so that command input is echoed after history substitution. 

-X Sets the echo variable, so that commands are echoed immediately before execution. 

--V Causes the verbose variable to be set even before ‘.cshrc’ is executed. 

-X Is to —X as —V is to -v. 

After processing of flag arguments if arguments remain but none of the -e, -I, -n, or -t options 
was given the first argument b taken as the name of a file of commands to be executed. The 
shell opens thb file, and saves its name for possible resubstitution by ‘$0’. Since many systems 
use either the standard version 6 or version 7 shelb whose shell scripts are not compatible with 
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this shell, the shell will execute such a 'standard’ shell if the first character of a script is not a 
that is, if the script does not start with a comment. Remaining arguments initialize the vari¬ 
able argv. 

Signal handUng 

The shell normsdly ignores quit signals. Jobs running detached (either by or the bg or & 
commands) are immune to signals generated from the keyboard, including hangups. Other signals 
have the values which the shell inherited from its parent. The shell’s handling of interrupts and 
terminate signak in shell scripts can be controlled by onintr. Login shells catch the terminate sig¬ 
nal; otherwise this signal is passed on to children from the state in the shell’s parent. In no case 
are interrupts allowed when a login shell is reading the file ‘.logout’. 

FILES 

■/.cshrc 
■/.login 
■/.logout 
■/.history 
/bin/sh 
/tmp/sh* 

/etc/pas6wd 

LIMITATIONS 

Words can be no longer than 1024 characters. The system limits argument lists to 10240 charac¬ 
ters. The number of arguments to a command which involves filename expansion is limited to 
1/6’th the number of characters allowed in an argument Ibt. Command substitutions may substi¬ 
tute no more characters than are allowed in an argument list. To detect looping, the shell res¬ 
tricts the number of atiaa substititutions on a single line to 20. 

SEE ALSO 

8h(l), acces8(2), execve(2), fork(2), killpg(2), pipe(2), uma8k(2), getrlimit(2), setrlimit(2), 8igvec(2), 
wait(2), tty(4), a.out(5), environ(5). Using the C-Shell in the Beginner’s Guide to the Sun Worksta¬ 
tion 

BUGS 

When a command is restarted from a stop, the shell prints the directory it started in if this is 
different from the current directory; this can be misleading (that is, wrong) as the job may have 
changed directories internally. 

Shell builtin functions are not stoppable/restartable. Command sequences of the form ‘a ; b ; c’ 
are also not handled gracefully when stopping is attempted. If you suspend ‘b’, the shell will then 
immediately execute 'c’. This is especially noticeable if this expansion results from an alias. It 
suffices to place the sequence of commands in ()’s to force it to a subshell, that is, '( a ; b ; c )’. 

Control over tty output after processes are started is primitive; perhaps this will inspire someone 
to work on a good virtual terminal interface. In a virtusd terminal interface much more interest¬ 
ing things could be done with output control. 

Alias substitution is most often used to clumsily simulate shell procedures; shell procedures should 
be provided rather than aliased, 

Commmids within loops, prompted for by are not placed in the history list. Control structure 
should be parsed rather than being recognized as built-in commands. This would allow control 
commands to be placed anywhere, to be combined with ‘|’, and to be used with and ';’ 
meta^ntax. 

It should be possible to use the modifiers on the output of command substitutions. There are 
two problems with modifier usage on substitutions; not all of the modifiers are available; 
only one modifier per command substitution is allowed. 


Read at beginning of execution by each shell. 
Read by login shell, after ‘.cshrc’ at login. 

Read by login shell, at logout. 

Saved history for use at next login. 

Standard shell, for shell scripts not starting with a 
Temporary file for 

Source of home directories for ’■name’. 


Sun Release 1.1 


Last change: 13 March 1984 


77 



CSH(l) 


USER COMMANDS 


CSH(l) 


Quoting conventions are contradictory and confusing. 

Symbolic links fool the shell. In particular, dire and ‘cd ..’ don’t work properly once you’ve 
crossed through a qrmbolic link. 

net path should remove duplicate pathnames from the pathname list. These often occur because 
a shell script or a .ethre file does something like set paths(/usr/loeal /usr/hosts Ipath) 
to ensure that the named directories are in the pathname list. 

There is no way to direct error output to one place and standard output to another place. 
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NAME 

ctags - create a tags file 
SYNOPSIS 

etaga ( -BFatuwvx ] file ... 

DESCRIPTION 

Ctag$ makes a tags file for ex{l) from the specified C, Pascal and FORTRAN sources. A tags file 
gives the locations of specified objects (in this case functions and typedefs) in a group of files. 
Each line of the tags file contains the object name, the file in which it is defined, and an address 
specification for the object definition. Functions are searched with a pattern, typedefs with a line 
number. Specifiers are given in separate fields on the line, separated by blanks or tabs. Using the 
tags file, ex can quickly find these objects definitions. 

Files whose name ends in .e or Ji are assumed to be C source files and are searched for C routine 
and macro definitions. Others are first examined to see if they contain any Pascal or FORTRAN 
routine definitions; if not, they are processed again looking for C definitions. 

The tag main is treated specially in C programs. The tag formed is created by prepending M to 
the name of the file, with a trailing .c removed, if any, and leading pathname components also 
removed. This makes use of ctage practical in directories with more than one program. 

OPTIONS 
-s 

-F 
-B 
-a 
-t 

-Vf 

-u 

FILES 

tags 

SEE ALSO 

ex(l), vi(l) 

BUGS 

Recognition of funetioM, eubroutines and procedures for FORTRAN and Pascal is done is a 
very simpleminded way. No attempt is made to deal with block structure; if you have two Pascal 
procedures in different blocks with the same name you lose. 

Does not know about #ifdefs. 


produce a list of object names, the line number and file name on which each is defined, as 
well as the text of that line and prints this on the standard output. This is a simple 
index which can be printed out as an off-line readable function index. 

use forward searching patterns (/.../) (default), 
use backward searching patterns (?...?). 
append to tags file, 
create tags for typedefs. 
suppress warning diagnostics. 

update the specified files in tags, that is, all references to them are deleted, and the new 
values are appended to the file. Beware: this option is implemented in a way which is 
rather slow; it is usually faster to simply rebuild the tags file. 

output tags file 
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NAME 

date - display or set the date 
SYNOPSIS 

date [ —u I (yymmddhbmm (•ss ] ] 

DESCRIPTION 

Date displays the current date and time when used without an argument. 

Only the supei^user may net the date, yy is the last two digits of the year; the first mm is the 
month number; id is the day number in the month; hh is the hour number (24 hour qrstem); the 
second mm is the minute number; ,»$ (optional) specifies seconds. The year, month and day may 
be omitted; the current values are supplied as defaults. 

OPTIONS 

-u Display the date in GMT (universal time). The system operates in GMT; date normally 
takes care of the conversion to and from locsd standard and daylight time. —u may also 
be used to set GMT time. 

EXAMPLE 

date 10080045 

sets the date to Oct 8, 12:45 AM. 

FILES 

/usr/adm/wtmp to record time>setting 

SEE ALSO 

utmp(5) 

DIAGNOSTICS 

‘Failed to set date: Not owner’ if you try to change the date but are not the super*user. 
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NAME 

dbx - debugger 
SYNOPSIS 

dbx ( -r ] (-11 [ -I dir ) [ objfite ) ( eoredump ] 

DESCRIPTION 

Dbx is a tool for source level debugging and execution of programs under the UNDC operating sys¬ 
tem. Objfile is an object file produced by a compiler with the appropriate flag (-g) specified to 
produce symbol information in the object file. IMPORTANT: every stage of the compile process, 
including the Id phase, should include the -g option. Currently, cc(l) and /77(1) produce the 
appropriate source information. 

If no objfile is specified, dbx looks for a file named a,out in the current directory. The object file 
contains a symbol table which includes the names of all the source files translated by the compiler 
to create it. These files are available for perusal while using the debugger. 

If a file named core exists in the current directory or a coredump file is specified, dbx can be used 
to examine the state of the program when it faulted. 

Debugger commands in the file .dbxinit are executed if that file exists either in the current direc¬ 
tory, or in the user’s home directory if •dbxinit doesn’t exist in the current directory. 

OPTIONS 

-7 Execute objfile immediately. Parameters follow the object file name (redirection is recog¬ 
nized). If the program terminates successfully dbx exits. Otherwise dbx reports the reason 
for termination and waits tor user response. Dbx reads from Idevftty when -r is specified 
and standard input is not a terminal. 

-I Force dbx to Mt as though standard input is a terminal. 

-I Add dir to the list of directories that are searched when looking for a source file. Nor¬ 
mally dbx looks for source files in the current directory and in the directory where objfile 
is located. The directory search path can also be set with the use command. 

D&s just prompts and waits for a command unless -r is specified. 

DBX INTERFACE 

The dis interface for debugging programs consists of several groups of commands: 

Execution and Tracing 

Runs the program being debugged, traces its execution, and stops at selected places. 
Displaying and Naming Data 

Displays data and locates variables in the debugged program. 

Accessing Source Files 

Provides operations (such as editing) on the actual source text of the program. 

Machine Level Commands 

Provides access to memory locations and machine registers. 

Miscellaneous 

Miscellaneous commands such as help, and caU up a shell. 

The most useful basic'commands to know about are run to run the program being debugged, 
where to obtain a st^k backtrace with line numbers, print for displaying variables, and stop 
for setting breakpoints. 
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E<xpr«Mloiu 

Dbx Exprettiotu are combinatioiis of variables, constants, procedure calls, and operators. Freeze 
hexadecimal constants by a ‘Ox’ and octal constants by a ‘O’. Enclose character constants in sin¬ 
gle quotes. Expressions cannot involve strings, structures, or arrays, although elements of struc¬ 
tures or arrays may be used. 

Dbx recognizes these operators: 

+ -•/*■»% 

add, subtract, multiply, divide, integer divide and remainder. 

« » 

left shift and right shift. 

address of operator, and contents of operator. 

< > <— >— —— !— 

less than, greater than, less than or equal, greater than w equal, equal to, and not equal to. 

ftft II 

logical and, and logical or. 

‘^)ie held reference operator (‘.’) can be used with pointers as well as records, making the C operap 
tor ‘->’ unnecessary (although it is supported). 

Precedence and associativity of operators are the same as C. Parentheses can be used to change 
precedence of operators. 

Of course, if the program being debugged is not active and there is no core file, you may only use 
expressions containing constants — procedure calls require an active child process. 

Dbx and Fortran 

Note the following when using dbx with Fortran programs: 

1. Array elements must be referenced with square brackets ‘[’ and ']’ rather than 
parentheses, that is, print whatslt[8] instead of print what8lt(S). 

2. The main routine is referenced as MAJN (as distinguished from ‘main’). All other names 
in the source file which have upper case letters in them will be lower case in dbx, unless 
the -U option ot f77 is used to compile the program. 

3. When referring to the value of a logical type in an expression, use the value 0 or 1 rather 
than true or falte. 

Dbx Scope Rules 

Dbx has two external variables which it uses to resolve scope confiicts. These are called ‘file’ and 
‘func’ — see section 3, Aecetring Source Files. The values of ‘file’ and ‘func’ change automati¬ 
cally as files and routines are entered and exited during execution of the user program. ‘File’ and 
‘func’ can also be changed by the user. Changing ‘func’ also changes the value of ‘file’; however, 
changing ‘file’ does not change ‘func’. 

‘Func’ is usej for name resolution, as in the command: print grab where grab may be defined in 
two different routines. The search order (for C and Fortran programs at the time of writing) is: 

1. Search (or ‘grab’ fh the routine named by ‘func’, " 

2. If ‘grab’ doesn’t exist in the routine named by ‘func’, the file containing the routine named 
by ‘func’ is searched, 

3. finally the next outer level — the whole program in the ease of C and Fortran — is searched 
for ‘grab’. 
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Clearly, if ^grab’ is local to a different routine than the one nsuned by 7onc’, or is a static variable 
in a different file than is the routine named by ^func’, it won’t be found. Note, however, that 
print a.grab is allowed, as long as routine ^a’ was entered and not exited yet. Note that the file 
that routine *a’ is in might have to be specified in the expression when the file name (minus suffix) 
is the same as a routine name. For example, if routine 'a’ is found in module 'a.c’, then 
print a.grab would be not enough — you would have to use print a.a*grab. If you are in 
doubt as to how to specify a name, use the whereis command, as in wherein grab to display 
the full qualifications of all instances of the specified name (grab in this case). 

Tile’ is used to: 

1. resolve conflicts when setting ’func’ — for example, when a C program has two static rou¬ 
tines with the same name, 

2. know which file to use for commands which take only a source line number — for example, 
stop at 55, and: 

3. know which file to use for commands such as the ’edit’ command which has optional argu¬ 
ments or no arguments at all. 

When dbx first comes up, the value of ’file’ is the first source file in the compiler/load list and the 
value of ’func’ is the module for this same file (that is, without the suffix ’.c’ or ’.f’). This causes 
name resolution to take place on a global level, that is, names are resolved such that the most 
global element is found. As soon as execution begins, however, ’func’ always has a value 
corresponding to a routine name. 

Note that changing ’|unc’ doesn’t affect the place where dbx continues execution when the pro¬ 
gram is restarted. 

1. Execution nnd Tracing Commands 
run [< filename] [> filename] 

Start executing objfilCf passing args as command line arguments; < or > can be used to 
redirect input or output in the usual manner. Otherwise, all characters in args are passed 
through unchanged. If no arguments are specified, the argument list (if any) typed previ¬ 
ously is used. If objfile has been written since the last time the symbolic information was 
read in, dix reads in the new information. 

coot [at source-line-number] [number] 

Continue execution from where it stopped, or, if the clause ’at source-tine-number^ is given, 
from that line number. The clause number causes execution to continue as if that signal 
had occurred. 

Source-line-number is evaluated relative to the current ’file’ and must be within the current 
procedure/function or the stack will be incorrect and unexpected behavior will result. Exe¬ 
cution cannot be continued if the process has ’finished’, that is, called the standard pro¬ 
cedure ’exit’. Dbx does not allow the process to exit, thereby letting the user examine the 
program state. 

trace [In procedure/function] [V condition] 
source-tine-number [V condition] 
trace procedure/function (If condition] 
trace expression sA source-line-number \\t condition] 
trace variable [In procedure/function] [If condition] 

Display tracing information when the program is executed. A number is associated with the 
command that is used to turn the tracing off (see the delete command). 

If no argument is specified, sll source lines are displayed before they are executed. Execu¬ 
tion is substantially slower during this form of tracing. 

The clause ’In procedure/functiori restricts tracing information to be displayed only while 
executing inside the given procedure or function. Note that the 'procedure/function' traced 
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must be visible in the scope in which the trace command is issued — sec the */unc‘ com- 
mand. 

Condition is a Boolean expression and is evaluated prior to displaying the tracing informar 
tion; the information is displayed only if condition is true. 

The first argument describes what is to be traced. The effects of different kinds of argu* 
ments are described in the list below. 

Source Line Number 

Display the line immediately prior to executing it. Source line numbers in a file 
other than the current one must be preceded by the name of the file in quotes and a 
colon, for example, *mumble.p’*:17. 

Procedure or Function Name 

Every time the procedure or function is called, display information telling what rou¬ 
tine called it, from what source line it was called, and what parameters were passed 
to it. In addition, its return is noted, and if it^s a function, also display the value 
the function is returning. 

Expression 

If the argument is an expression with an at clause, the value of the expression is 
displayed whenever the identified source line is reached. 

Variable 

The name and value of the variable is displayed whenever it changes. Execution is 
substantially slower during this form of tracing. 

Tracing is turned off whenever the block in which it was turned on is exited. For instance, if the 
program is stopped inside some procedure and tracing is invoked, the tracing will end when the 
procedure is exited. To trace the whole program, tracing must be invoked before issuing the run 
command. 

stop If condition 

atop at source-line-number (If condition] 
stop in procedure!function [If condition] 
stop variable [If condition] 

Stop execution when the given line is reached, procedure or function called, variable 
changed, or condition true. 

when In procedure!function { command; ...} 
when at source-line-number { command ;...} 
when Boolean condition { command ;...} 

Execute the given dbx commands when the procedure or function is called, line number is 
reached, or Boolean condition is true. The braces and semicolon, separating each command, 
are mandatory. 

status [> filename] 

Display the currently active trace and atop commands, 
delete command-number 

Remove the trace or stop corresponding to the given number. The status command 
displays the numbers associated with traces and stops. 

catch number 
ignore number 

Start or stop trapping signal number before it is sent to the program. This is useful when a 
program being debugged handles signals such as interrupts. Initially all signals are trapped 
except SIGHUP, SIGCONT, SIGCHILD, SIGALRM, SIGKILL, SIGSTP, and SIGWINCH. 

step Execute one source line. 

next Execute up to the next source line. The difference between this and step is that if the line 
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O 


contains a call to a procedure or function step stops at the beginning of that routine, while 
next does not. 

2. Displaying stnd Nsimlng Data 
print expretnon {y exprexHon ... ] 

Display the values of the expressions. Variables having the same identifier as one in the 
current block may be referenced as * hlock-namt.variable', where bloek-name is a unique 
identifier for a block. For exmnple, to access variable ‘c’ inside routine ‘a’ which is 
declared inside module ‘a.c*, you would have to use print a.a^ to make the name ‘a’ 
unambiguous. Use wrhareb to find the qualified name of an identifier. 

whatls name 

Print the declaration of the given name, which may be qualified with block names as 
above. 

which identifier 

Print the fuU qualification of the given identifer, that is, the outer blocks that the 
identifier is associated with. 

wherelt identifier 

Print the full qualification of all the ^mbols whose name matches the given identifier. 
The order in^ which the symbok are displayed is not meaningful. 

assign variable expreeeion 
set variable a expression 

Assign the value of the expression to the variable. Currently no type conversion takes 
place if operands are of different types. 

call procedurefparameters) 

Execute the object code associated with the named procedure or function. If the source 
file that the routine k defined in was compiled with the -g fiag, the number and type of 
parameters must match. However, if C routines are called which are not compiled with 
the -g fiag, dbx wUI not do parameter checking. The parameters are simply pushed on the 
stack as given in the parameter Ikt, Currently, string and structure parameters are not 
passed properly for C and parameters greater than four bytes (for example, complex and 
double precision variables) and alternate return points are not passed properly for For¬ 
tran. L 

where Display a list of the active procedures and functions, 
dump I > filename] 

Show the names and values of all active variables. 



S. Accesalug Source Files 

edit [filename] 

edit procedure/funetion-name 

Invoke an editor on filename or the current source file if none is specified. If a procedure 
or function name is specified, the editor k invoked on the file that contains it. Which edi¬ 
tor k invoked by default depends on the installation. The default can be overridden by 
setting the environment variable EDITOR to the name of the desired editor. 

flic [filename] 

Change the current source file name to filename (apple.c for instance). Display the 
current source file name if no filename is specified. 

func [procedure/function/program name) 

Change the current function. Display the current function if none is specified. Changing 
the current function implicitly changes the current source file variable file to the one that 
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contains the function; it also changes the current scope used for name resolution. If the 
entire scope of the program is desired, the argument should be the object file name. 

list \source-line-number |, »fl«rce-/ine-»um6erjj 
list proeeiureffunction 

List the lines in the current source file from the first line number to the second inclusive. 
If no lines are specified, the next 10 lines are listed. If the name of a procedure or func¬ 
tion is given lines n-k to n+ k are listed where n is the first statement in the procedure or 
function and h is small. If the list command’s argument is a procedure or function, the 
scope for further listing is changed to that routine — use the file command to change it 
back. 

use directory-list 

Set the list of directories to be searched when looking for source files. 

4. Machine Level Commands 

trace! [address] [tt eond\ 
traeel [vartsife] [at address) [If eond] 
stopi [variable] [If cond] 
stopl [at) (address) [If cond) 

Turn on tracing or set a stop using a machine instruction address. 

stepl 

nextl 

Single step as in step or next, but do a sugle instruction rather than source line. 

address ,addre8s/ [ mode] 

[address) / [ count] [ mode) 

Display the contents of memory starting at the first address and continuing up to the second 
address or until coun< items are displayed. If no address is specified, the address following 
the one displayed most recently is used. The mode specifies how memory is to be displayed; 
if it is omitted the previous mode specified is used. The initial mode is ‘X’. The following 
modes are supported: 

1 display the machine instruction 

d display a short word in decimal 

D display a long word in decimal 

o display a short word in octal 

O display a long word in octal 

X display a short word in hexadecimal 

X display a long word in hexadecimal 

b display a byte in octal 

e display a byte as a character 

• display a string of characters terminated by a null byte 

f display a single precision real number 

g display a double precision real number 

Symbolic addresses used in this context are specified by preceding the name with an Regis* 
ters are denoted by *$d0-$d7* (data registers), ‘$a0-$a7’ (address registers), ‘Ifp’ (frame pointer), 
‘Isp’ (stack pointer), and ‘$pc’ (program counter). Note that $fp is equivdent to register a6 and 
$sp is equivalent to register a7. For example, to print the contents of all registers in hex, you 
would type “&ld0/20X” or “&$dO,&$a7/X”. To print the contents of register dO, you could also 
type “print $d0’’ (you can’t currently specify a range with print). Addresses may be expressions 
made up of other addresses and the operators ‘+ ’,and indirection (unary '*’). 
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S. Miscellaneous Commands 

sh command-line 

Pass the command line to the shell for execution. The SHELL environment variable 
determines which shell is used. 

alias new-command-name old-command-name 

Respond to new-command-name as though it were old-command-name. 

help (eont ] [trace ] (stop ] [when ] 

Display a synopsis of dbx commands. If an argument is given, the synopsis b restricted to 
show variations of only that particular command. 

aouree filename 

Read dbx commands from the given filename. Especially useful when the filename has been 
created by redirecting a status command from an earlier debugging session. 

quit Exit dbx. 

FILES 

a.out default object file 

core default core file 

"/•dbxinit initial commands 

SEE ALSO ^ 

cc(l) C compiler 
f77(l) Fortran compiler 
pc(l) Pascal compiler 

COMMENTS 

Dbx suffers from a ^multiple include* malady. If you have a program consisting of a number of 
object files and each b buUt from source files that include header files, the symbolic information 
for the header files b replicated in each object file. Since about one debugger start-up b done for 
each link, having the linker (Id) re-organize the ^mbol information won’t save much time, though 
it would reduce some of the dbk space used. The problem b an artifact of the unrestricted 
semantics of #include*8 in C; for example an include file can contain static declarations that are 
sepsu'ate entities for each file in which they are included. 

Currently the only way to type cast b on the machine level using the mode specifier (e.g. 
print (char p is not allowed). 

Dbx does not correctly handle expressions involving pointers to objects where the pointer is offset 
by some integer value (for example, *(p-5)). 

BUGS 

Dbx doesn’t handle Fortran entry points well — it treats them as if they were independent rou¬ 
tines. 

Dbx doesn’t handle aseigning to C bit fields and Fortran complex types correctly (see the 
aiBignfeet command). 

The use command and 4 option don’t override the current directory if there b source by the same 
name in the current directory. 

If you link with the -g flag but don’t compile anything with it, dbx core dumps when reading in 
the object file. 
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NAME 

de - desk calculator 

SYNOPSIS 

dc(file] 

DESCRIPTION 

De is an arbitrary precision arithmetic package. Ordinarily it operates on decim^ integers, but 
one may specify an input base, output base, and a number of fractional digits to be maintained. 
The overall structure of de is a stacking (reverse Polish) calculator. If an argument is given, input 
is taken from that file until its end, then from the standard input. The following constructions 
are recognized: 

number 

The value of the number is pushed on the stack. A number is an unbroken string of the 
digits 0-9. It ms^ be preceded by an underscore _ to input a negative number. Numbers 
may contain decimal points. 

+ -/•%* 

The top two values on the stack are added (-I-), subtracted (-), multiplied (*), divided (/), 
remaindered {%), or exponentiated ('). The two entries are popped off the stack; the 
result is pushed on the stack in their place. Any fractional part of an exponent is ignored. 

»x The top of the stack is popped and stored into a register named x, where x may be any 
character. If the a is capitalized, x is treated as a stack and the value is pushed on it. 

lx The value in register x is pushed on the stack. The register x is not altered. AH registers 
start with zero value. If the 1 is capitalized, register x is treated as a stack and its top 
value is popped onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains unchanged. P interprets the 

top of the stack as an ascii string, removes it, and prints it. 

f All values on the stack and in registers are printed. 

q exits the program. If executing a string, the recursion level is popped by two. If q is capi¬ 
talized, the top value on the stack is popped and the string execution level is popped by 
that value. 

X treats the top element of the stack as a character string and executes it as a string of dc 
commands. 

X replaces the number on the top of the stack with its scale factor. 

(... ] puts the bracketed ascii string onto the top of the stack. 

<z >z *=» 

The top two elements of the stack are popped and compared. Register z is executed if 
they obey the stated relation. 

V replaces the top element on the stack by its square root. Any existing fractional part of 
the argument is taken into account, but otherwise the scale factor is ignored. 

! interprets the rest of the line as a UNIX command, 
e All values on the stack are popped. 

I The top value on the stack is popped and used as the number radix for further input. I 
pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as the number radix for further output. 

O pushes the output base on the top of the stack. 

k the top of the stack is popped, and that value is used as a non-negative scale factor: the 


88 


Last change: 2 June 1983 


Sun Release 1.1 




DC(1) 


USER COMMANDS 


DC(1) 


appropriate number of places are printed on output, and maintained during multiplication, 
division, and exponentiation. The interaction of scale factor, input base, and output base 
will be reasonable if all are changed together. 

B The stack level is pushed onto the stack. 

Z replaces the number on the top of the stack with its length, 
f A line of input is taken from the input source (usually the terminal) and executed. 

11 are used by be for array operations. 

EXAMPLE 

Print the first ten values of n! 

(lal+ dsa*plalO>y)sy 

Osal 

lyx 

SEE ALSO 

bc(l), which is a preprocessor for de providing infix notation and a C-like ^ntax which imple* 
ments functions and reasonable control structures for programs. 

DIAGNOSTICS 

‘x is unimplemented’ where x is an octal number. 

’stack empty’ for not enough elements on the stack to do what was asked. 

‘Out of space’ when the free list is exhausted (too many digits). 

‘Out of headers’ for too many numbers being kept around. 

‘Out of pushdown’ for too many items on the stack. 

‘Nesting Depth’ for too many levels of nested execution. 
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NAME 

dd - convert and copy a file 

SYNOPSIS 

dd (option^value) ... 

DESCRIPTION 

Dd copies a specified inpat file to a specified output with possible conversions. The standard 
input and output are used by default. The input and output block size may be specified to take 
advantage of raw physical I/O. 

OPTION VALVES 


Ifsssname 

ofssnsme 


Ibsssn 

obassn 

bamt 

ebsssn 

aklpasn 

fllaasn 

aeek=n 


counts n 

eonvsascii 

ebcdic 

ibm 

block 

unblock 

lease 

ucase 

swab 

noerror 

sync 


input file is taken from name; standard input is default. 

output file is taken from name; standard output is default. Note that dd creates 
and explicit output file; therefore the seek option is usually useless with explicit 
output except in special cases such as using magnetic tape or raw disk files. 

input block size n bytes (default 512). 
output block size n bytes (default 512). 

set both input and output block size, superseding lbs and obs; also, if no conver* 
sion is specified, it is particularly efficient since no copy need be done 

conversion buffer size 

skip n input records before starting copy 

copy n input files before terminating (makes sense only when input is a magtape 
or similar device). 

seek n records from beginning of output file before copying. This option gen¬ 
erally only works with magnetic tapes and raw disk files and is otherwise usually 
useless if the explicit output file was named with the of option. 

copy only n input records 

convert EBCDIC to ASCII 

convert ASCII to EBCDIC 

slightly different map of ASCII to EBCDIC 

convert variable length records to fixed length 

convert fixed length records to variable length 

map alphabetics to lower case 

map alphabetics to upper case 

swap every pair of bytes 

do not stop processing on an error 

pad every input record to ib$ 

several commarseparated conversions 


Where sizes are specified, a number of bytes is expected. A number may end with k (kilobytes) 
to specify multiplication by 1024, b (blocks of 512 bytes) to specify multiplication by 512, or w 
(words) to specify multiplication by 4; a pair of numbers may be separated by x to indicate a pro¬ 
duct. 


Cbn is used only if ascU, unblock, ebedle, ibm, or block conversion is specified. In the first 
two cases, cbn characters are placed into the conversion buffer, any specified character mapping is 
done, trailing blanks trimmed and new-line added before sending the line to the output. In the 
latter three cases, characters are read into the conversion buffer, and blanks added to make up an 
output record of size cbu. 

After completion, dd reports the number of whole and partial input and output blocks. 
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EXAMPLE 

To read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into the ASCII file z: 
tutorial% dd Ifsa/dev/rmtO ofsx ib8=800 ebsssfiO eonva=nseIl,lease 

Note the use of raw magtape: dd is especially suited to I/O on the raw physical devices because it 
allows reading and writing in arbitrary record sizes. 

SEEAl^SO 

cp(l), tr(l) 

DIAGNOSTICS 

f+ p records iii(out): numbers of full and partial records read(written) 

BUGS 

The ASCn/EBCDlC conversion tables are taken from the 256 character standard in the OACM 
Nov, 1968. The ibm conversion, while less blessed as a standard, corresponds better to certain 
IBM print train conventions. There is no universal solution. 
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NAME 

delta - make a delta (change) to an SGCS file 
SYNOPSIS 

/usr/seea/delta ( -rS/D 1 |-■ ] ( -n J ( J ( -m( mrliat] J (-y(comment) ( (-p ( file ... 
DESCRIPTION 

Delta permanently introduces into the named SGCS file changes that were made to the file 
retrieved by yet(l) (called the g-file, or generated file). 

Delta makes a delta to each named SGCS file. If a directory is named, delta behaves as though 
each file in the directory were specified as a named file, except that non>SCGS files (last com¬ 
ponent of the path name does not begin with a.) and unreadable files are silently ignored. If a 
name of — is given, the standard input is read (see WARNINGS); each line of the standard input is 
taken to be the name of an SGCS file to be processed. 

Delta may issue prompts on the standard output depending upon certain options specified and 
flags (see <idmtn(I)) that may he present in the SGCS file (see -m and -y options below). 

OPTIONS 

Options apply independently to each named file. 

—r SID Uniquely identifies which delta is to be made to the SGCS file. The use of this option is 
necessary only if two or more outstanding get's for editing (get -e) on the same SGCS file 
were done by the same person (login name). The SID value specified with the -r option 
can be either the SID specified on the get command line or the SID to be made as reported 
by the get command (see irel(l)). A diagnostic results if the specified SID is ambiguous, 
or, if necessary and omitted on the command line. 

-■ Do not display the created delta’s SID, number of lines inserted, deleted and unchanged in 
the sees file. 

-n . Retain the edited g~file which is normally removed at completion of delta processing. 

-g lift Specifies a list of deltas to be ignored when the file is accessed at the change level (SID) 
created by this delta. See ;e((l) for the definition of list. 

~m{ mr/tX] 

If the sees file has the v flag set (see admin{l)), a Modification Request (MR) number 
must be supplied as the reason for creating the new delta. 

If -m is not used and the standard input is a terminal, the prompt MRst is issued on 
the standard output before the standard input is read; if the standard input is not a ter¬ 
minal, no prompt is issued. The MRs? prompt always precedes the eommentaf prompt 
(see -y option). 

MRs in a list are separated by blanks and/or tab characters. An unescaped new-line 
character terminates the MR list. 

Note that if the v flag has a value (see aimm(I)), it is taken to be the name of a program 
(or shell procedure) which will validate the correctness of the MR numbers. If a non-zero 
exit status is returned from MR number validation program, delta terminates (it is 
assumed that the MR numbers were not all valid). 

-y|c<»mmen<) 

Arbitrary text to describe the reason for making the delta. A null string is considered a 
valid comment. 

If -y is not specified and the standard input is a terminal, the prompt comments? is 
issued on the standard output before the standard input is read; if the standard input is 
not a terminal, no prompt is issued. An unescaped new-line character terminates the 
comment text,. 
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-p Display (on the standard output) the SCCS file differences before and after the delta is 
applied in a format. 

FILES 

All files of the form f-file are explained in the Source Code Control System User's Guide. The 
naming convention for these files is also described there. 

g-file Existed before the execution of de/fa; removed after completion of delta. 

P'file Existed before the execution of delta) may exist after completion of delta. 

<)-file Created during the execution of delta) removed after completion of delta. 

X'flle Created during the execution of delta) renamed to SGGS file after completion of 

delta, 

z-file Created during the execution of delta) removed during the execution of delta. 

d’file Created during the execution of delta) removed after completion of delta. 

/bin/diff Program to compute differences between the “gotten” file and the g-file. 

WARNINGS 

Lines beginning with an SOH ASGII character (binary 001) cannot be placed in the SGGS file 
unless the SOH is escaped. This character has special meaning to SGGS (see secsfite(5)) and will 
cause an error. 

A get of many SGGS files, followed by a delta of those files, should be avoided when the get gen* 
erates a large amount of data. Instead, multiple get/delta sequences should be used. 

If the standard input (-) is specified on the delta command line, the -m (if necessary) and -y 
options must also be present. Omission of these options is an error. 

SEE ALSO 

8CC8(1), admin(l), get(l), help(l), pr8(l), 8CC8file(5). 

Source Code Control System in Programming Tools for the Sun Workstation. 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME 

deroff - remove nroff, troff, tbl and eqn constructs 

SYNOPSIS 

4eroff (—w) file ... 

DESCRIPTION 

Deroff reads each file in sequence and removes aU nroff and troif command lines, backslash con¬ 
structions, macro definitions, eqn constructs (between ‘£Q’ and *£N’ lines or between delim¬ 
iters), and table descriptions and writes the remainder on the standard output. Deroff follows^ 
chains of included files (‘.so’ and ‘mx’ commands); if a file has already been included, a ‘.so’ is 
ignored and a ‘.nx’ terminates execution. If no input file b given, deroff from the standard 
input file. 

OPTIONS 

-w Generate a word list, one word per line. A ‘word’ is a string of letters, digits, and apos¬ 
trophes, beginning with a letter; apostrophes are removed. All other characters are 
ignored. 

SEE ALSO 

troS(l), eqn(l), tbl(l) 

BUGS 

Deroff a not a complete Ircjf interpreter, so it can be confused by subtle constructs. Most errors 
result in too much rather than too little output. 
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NAME 

df - report free disk space on file systems 
SYNOPSIS 

df [ -1 ] ( filesystem ...][ file ... ] 

DESCRIPTION 

D/displays the amount of disk space occupied by each file system, the amount of this space which 
is used and available, and how much of the file system’s total capacity has been used. Used 
without arguments, df produces somethmg like; 

% df 


Filesystem 

kbytes 

used 

avail 

capacity 

Mounted on 

/dev/ipOa 

7445 

4714 

1986 

70% 

/ 

/dev/ipOg 

42277 

35291 

2758 

93% 

/usr 


% 

Note that used+ avail is less than the amount of space in the file system (kbytes); this is because 
the system reserves a fraction of the space in the file ^stem to allow its file system allocation rou¬ 
tines to work well. The amount reserved is typically about 10%; this may be adjusted using 
f«ne/«(8). When all the space on a file system except for this reserve is in use, only the super-user 
can allocate new fil^ and data blocks to existing files. When a file system is overallocated in this 
way, df may report that the file system is more than 100% utilized. 

If arguments to are disk partitions (for example, fdevJipOa) or UNDC path names, df produces a 
report on the file system containing the named file. Thus “df shows the amount of space on the 
file system containing the current directory. 

OPTIONS 

-1 Report also the number of used and free inodes. 

FILES 

/ete/fstab list of normally mounted filesystems 
SEE ALSO 

du(l), f8tab(S), icheck(8), quot(8), tunefB(8) 
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NAME 

diff - differential file and directory comparator 
SYNOPSIS 

dlff -eefhn-b]filelfile2 
diff -Dstring ] { -b | filel file2 

dlff -11 (-** 1 I -■ 11! I -Sfiome) ( -cefh) | -b J dirl dir2 
DESCRIPTION 

diff is a differential file comparator. When run on regular flies, and when comparing text files 
which differ during directory comparison (see the notes below on comparing directories), diff tells 
what lines must be changed in the files to bring them into agreement. Except in rare cir¬ 
cumstances, diff finds a smallest sufficient set of file differences. If neither filtl nor file2 is a direc¬ 
tory, either may be given as in which case the standard input is used. If filel is a directory, a 
file in that directory whose file-name is the same as the file-name of fileB is used (and vice versa). 

There are several options for output format; the default output format contains lines of these 
forms: 

ni a nS,n4 
nl,nB d nS 
nl,nBc nS,n4 

These lines resemble ed commands to convert filel into filet. The numbers after the letters per¬ 
tain to filet. In fact, by exchanging ‘a’ for ‘d’ and reading backward one may ascertara equally 
how to convert filet into filel. As in ed, identical pairs where nl ^ nt or nS n4 ut abbrevi¬ 
ated as a single number. 

Following each of these lines come all the lines that are affected in the first file flagged by '<’, 
then all the lines that are affected in the second file flagged by *>’. 

If both arguments are directories, diff sorts the contents of the directories by name, and then runs 
the regular file diff program as described above on text files which are different. Binary files 
which differ, common subdirectories, and files which ^pear in only one directory are listed. 

OPTIONS 

Except for -b, which may be given with any of the others, the following options are mutuaUy 
exclusive: 

-« produce a script of a, e and d commands for the editor ed, which will recreate filet from 

filel. In connection with -e, the following shell program m^ help maintain multiple ver¬ 
sions of a file. Only an ancestral file ($1) and a chain of version-to-version ed scripts 
($2,$3,...) made by diff need be on band. A 'latest version’ appears on the standard out¬ 
put. 

(shift; cat $*; echo l,lp') | ed - $1 

Extra commands are added to the output when comparing directories with -e, so that the 
result is a «/i(l) script for converting text files which are common to the two directories 
from their state in dirl to their state in dirt. 

-t produces a script similar to that of -e, not useful vrith ed, and in the oppoeite order. 

-e produces a diff with lines of context. The default is to present 3 lines of context and may 

be changed, (to 10, for example), by -elO. With -e the output format is modified 
slightly: the output beginning with identification of the files involved and their creation 
dates and then each change is separated by a line with a dozen *’s. The lines removed 
from filel are marked with those added to filet are marked ’. Lines which are 
changed from one file to the other are marked in both files with 

-h does a fast, half-hearted job. It works only when changed stretches are short and well 
separated, but does work on files of unlimited length. 
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Options for the second form of diff are as follows: 

-Dstring 

create a merged version of filel and fileS on the standard output, with C preprocessor con¬ 
trols included so that a compilation of the result without defining $tring is equivalent to 
compiling filel, while defining etring will yield fileS. 

-b ignore trailing blanks (spaces and tabs); other strings of blanks compare equal. 

Options when comparing directories are: 

-1 long output format; each text file diff is piped through pr(l) to paginate it, other 
differences are remembered and summarized after all text file differences are reported. 

-T apply d(irrecursively to common subdirectories encountered. 

-a report files which are the same, which are otherwise not mentioned. 

-Sname 

starts a directory in the middle, beginning with file name. 

FILES 

/tmp/d??m 
/usr/lib/diffh for -h 
/usr/bin/pr 

SEE ALSO 

cmp(l), cc(l), comm(l), ed(l), diff3(l) 

DIAGNOSTICS 

Exit status is 0 for no differences, 1 for some, 2 for trouble. 

BUGS 

Editing scripts produced under the -• or -f option are naive about creating lines consisting of a 
single 

When comparing directories with the -b option specified, diff first compares the files (as in cmp), 
and then decides to run the diff algorithm if they are not equal. This may cause a small amount 
of spurious output if the files then turn out to be identical, because the only differences are 
insignificant blank string differences. 
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NAME 

diff3 - 3-way differential file comparison 
SYNOPSIS 

dura I -cx3 ] filel file2 file3 
DESCRIPTION 

DiffS compares three versions of a file, and publishes disagreeing ranges of text flagged with these 
codes: 

aasssas all three files differ 

ssssssi jUel is different 

filtS is different 
ssMsS files is different 

The type of change suffered in converting a given range ot a given file to some other is indicated 
in one of these ways: 

/1 ni a Text is to be appended after line number ni in file f, where l, 2, or 3. 

f ml fttS c Text is to be changed in the range line ni to line nS. If ni nS, the range 
may be abbreviated to nl. 

The original contents of the range follows immediately after a e indication. When the contents of 
two files are identical, the contents of the lower-numbered file is suppressed. 

Under the -« option, difiS publishes a script for the editor ed that will incorporate into filel aU 
changes between fileS and fileS, t.e. the changes that normally would be flagged sssss and 
EsasaasS. Option -X (-3) produces a script to incorporate only changes flagged Bssa 
(saaaBtBS). The following command will apply the resulting script to ‘filel’. 

(cat script; echo l,$p') | ed - filel 

FILES 

/tmp/d3?TTTT 

/usr/Ub/diff3 

SEE ALSO 
diff(l) 

BUGS 

Text lines that consist of a single will defeat -e. 
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NAME 

du - summarize disk usage 
SYNOPSIS 

du ( -8 I I -a ] ( name ... | 

DESCRIPTION 

Du gives the number of kilobytes contained in all files and, recursively, directories within each 
specified directory or file name. If name is missing,(the current directory) is used. 

A file which has multiple links to it is only counted once. 

OPTIONS 

-8 Onty display the grand total. 

-a Generate an entry for each file. 

Entries are generated only for each directory in the absence of options. 

EXAMPLE 

Here is an example of using du in a directory. We used the pwd command to identify the direc* 
tory, then used du to show the usage of all the subdirectories in that directory. The grand total 
for the directory is the last entry in the display: 

% pwd 

/usr/henry/misc 
% du 

5 ./jokes 

33 ./squash 

44 ./tech.papers/lpr.document 

217 ./tech.papers/new.manager 

401 ./tech.papers 

144 ./memos 

80 ./letters 

388 ./window 

93 ./messages 

15 ./usefuLnews 

1211 . 

% 

SEE ALSO 

df(l), quot(8) 

BUGS 

Non-directories given as arguments (not under -a option) are not listed. 

If there are too many distinct linked files, du counts the excess files multiply. 
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NAME 

echo - echo arguments 
SYNOPSIS 

echo { -n ] { argument...) 

DESCRIPTION 

Echo writes its arguments on the standard output. Arguments must be separated by spaces or 
tabs, and terminated by a newline. 

Echo IB useful for producing diagnostics in shell programs and for writing constant data on pipes. 
If you are using the Bourne Shell (sA(l)), you can send diagnostics to the standard error file by 
typing: 'echo... 

OPTIONS 

-o Don’t add the newline to the output. 


o 


o 


o 
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NAME 

cd - text editor 
SYNOPSIS 

ed I - ] ( -X ] [ filename ] 

DESCRIPTION 

Ed is the basic text editor in the UNIX system. While ed is for all practical purposes superseded 
by vif ed is still used by other system utilities such as sees. Ed is a line editor — in general, you 
must specify the line or lines on which to perform the operation you choose (see Line Addreeeing, 
below, for a discussion of how to form line-addresses for ed)» You can tell ed to perform various 
operations on the lines. For instance, you can print (display) lines; you can change lines; you can 
insert new lines into the buffer; you can delete existing lines; you can move or copy lines to a 
different place in the buffer; you can substitute character strings within lines. See Liet of Opera- 
Hone, below, for a guide. AJso, see Regular ExpreoHone for string-matching metacharacters. 

Ed does not directly change the contents of a file — when editing a file, ed reads the contents of 
the file into a buffer or ecratchpad. All changes made during an editing session are made on the 
contents of this buffer. The copy must be ^saved’ or Written’ — using the u; (write) operation — 
to save changes. 

The command-line shown in the synopsis above invokes ed. If filename is given, ed reads a copy 
of filename into its buffer so that it can be edited (simulates an e operation on filename), 

Ed commands have a simple and regular structure: commands consists of an optional line-address, 
or two optional line-addresses separated by a comma, then a single letter operation, optionally fol¬ 
lowed by some other parameter: 

[line-addreea { Jine-addreee ] ] operation | parameter] 

For example, ‘l,10p’ means *print (display) lines 1 through 10’ (two line-addresses), *5a’ means 
^append after line 5’ (one line-address), and d means ’delete the current line’ (no line-address with 
the current line used as default). Parameter varies for each operation — for the move and 
transfer operations, for example, it is the line that the addressed lines are to be moved or 
transferred after. These operations actually have three line-addresses. For reading and writing a 
file, parameter specifies the name of the file that is to be read. 

Ed is extremely terse in its interaction with the user — erf’s normal response to just about any 
problem is simply a question mark ?. You get this response when, for instance, erf can’t find a 
specified line in the buffer, or if a search for a regular expression fails in a substitute (s) operation. 

OPTIONS 

- Suppress the display of character counts normally given by the e, r, and w operations — 
can be used when the standard input is an editor script. 

-X Simulate an x operation on the named file before reading it into the buffer, to handle 
encryption. 

LINE ADDRESSING 

The format of erf operations above shows that an operation can be preceded by one or two line- 
addresses, both of which are optional. If only one line-address is specified, operations are per¬ 
formed on that specific line. If two line-addresses are supplied, ed operates on the inclusive range 
of lines between them. 

Line-addresses are usually separated from each other by a comma — for instance: 
l,10p 

prints (displays) lines 1 thru 10. 

Line addresses may also be separated by a semicolon. Whereas the starting position for line- 
addresses separated by a comma is the same place in the buffer, when a line-address is followed 
by a semicolon, the current line is set to the line-address preceding the semicolon before any sub¬ 
sequent line-addresses are interpreted. For example: 
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/Domaine Chandon /; / /p 

sets the current line to the first occurrence of the string 'Domaine Chandon* before starting the 
search for the second occurrence. This feature can be used to determine the starting line for for¬ 
ward and backward searches 

Lines can be accessed (addressed, in ed terminology) in several ways, but the most easily under¬ 
stood way of addressing lines is by line number. Line numbers in ed are relative to the start of 
the buffer. In practice, addressing lines by number proves to be the most awkward to use, so ed 
provides other mechanisms for line-addressing. Note that the line numbers associated with lines 
in the buffer are not physically present with the text of the lines — they are just an addressing 
mechanism. 

While ed is working on the buffer, it keeps track of the line on which you last performed some 
operation. This line is called the 'current line*. As described below, you can indicate the current 
line by typing a period character (•)• 

If you don't specify a line for an operation to operate on, most ed operations work on the line 
addressed by the current line. 

When ed starts working on a file, the current line is positioned at the last line in the buffer. 
Thereafter, the current line usually changes when any operation b performed. In general, the 
current line sits at the last line affected by whatever ed operation you used. For instance, if you 
print lines 1 through 10 of the buffer, after the lines are dbplayed, the current line will be posi¬ 
tioned at line 10. 

Line-addresses are constructed from elements as shown in the list below. Some special characters 
are used as a shorthand for certain line-addresses: 

• ('dot') addresses the current line. 

$ addresses the last line of the buffer. 

nnn A decimal number nnn addresses the nnn-th line of the buffer. 

' z addresses the line marked with the name z, which must be a lower-case letter. Mark lines 
with the k operation described below. 

I r egular ezpreesioni 

A regular expression enclosed in slashes */’ searches forward from the current line and 
stops at the first line containing a string that matches the regular expression. If neces¬ 
sary, the search wraps around to the beginning of the buffer* 

^regular expression? 

A regular expression enclosed in question marks '7* searches backward from the current 
line and stops at the first line containing a string that matches the regular expression. If 
necessary the search wraps around to the end of the buffer. 

address±, nnn 

An address followed by a plus sign '+ * or a minus sign '-* followed by a decimal number 
specifies that line-address plus or minus the indicated number of lines. Plus b assumed if 
DO signs are given. 

± address 

An address beginning with '+ * or *-* b taken relative to the current line; in other words, 
'-5' b understood to mean ‘.-5*. 

address ± 

An address ending with *-f ’ or adds or subtracts 1. As a consequence of thb rule and 
the previous rule, the line-address refers to the line before the current line. Moreover, 
trailing '+ ’ and characters have cumulative effect, so ‘—’ refers to the current line 
less 2. 

To maintain compatibility with earlier versions of ed, the character in line-addresses is 
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equivalent to 

Ed operations do not necessarily use line-addresses; they may use one or two. Operations which 
don’t use line^addresses regard the presence of a line-address as an error. Operations which 
accept one or two line-addresses assume default line-addresses if these are not specified. If more 
line-addresses are given than such an operation requires, the last one or two (depending on what is 
accepted) are used. The second line-address of any two-address sequence must be greater than 
the first line-address — that is, the second line must follow the first line in the buffer. 

LIST OF OPERATIONS 

Ed operates in one two major modes: command mode and text input mode. Ed always starts up 
in command mode. 


While you are typing commands at ed, you are in command mode. Some commands — a for 
append, e for change, and I for Insert — provide for adding new text to the buffer. While ed is 
accepting new text, you are in text input mode. You exit from text input mode by typing a 
period alone at the beginning of a line. Ed then reverts to command mode. For example, here 
is a very short illustration of command mode versus text mode: 


example^ 
42 


ed wtnelist {tell ed to edit a file called winelist) 

(ed $tat€8 there are 4S characters in the file) 
(m command mode — tell ed to print all lines) 


1978 Chateau Chunder 

1979 Redeye Canyon 


. a 

1980 Doomsday Special 

e 

P 

1980 Doomsday Special 


(tn command mode — tell ed to append text) 

{text input mode — add a new tine) 

{period ends text input mode) 

{back in command mode — print last line entered) 


w 

65 

q 

exainple% 


{command mode — write the file) 

{ed displays the number of characters written) 
(command mode — quit the edit session) 
{back in the Shell) 


It you interrupt ed, it displays ‘Tinterrupted’ and returns to command mode, 
a Append Text. 

Heads the text entered in input mode and appends it to the buffer after the addressed 
line, a accepts one line-address — default line-address is the current line. The new 
current line is the last line input, or at the addressed line if no text is entered. Address 
*0’ is a valid place to append text, in which case text is placed at the beginning of the 
buffer. 

e Chaage Lines. • 

Deletes the addressed lines, then accepts input text which replaces these lines, c accepts 
two line-addresses — default line-address is the current line. The current line is left on 
the last line input, or at the line preceding the deleted lines if no text is entered. 

d Delete Lines. 

Delete the addressed lines from the buffer, d accepts two line-addresses — default line- 
address is the current line. The line originally after the last line deleted becomes the 
current line; if the lines deleted were originally at the end, the new last line becomes the 
current line. 

e filename Edit a file. 

Deletes the entire contents of the buffer, and then reads in the named file, e sets the 
current line to the last line of the buffer, and reports the number of characters read into 
the buffer, e remembers filename for possible use as a default file name in a subsequent r 
or w operatimis. If no filename is given, the remembered filename is used, e displays a T 
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if the buffer has not been written out since the last change made — a second e operation 
says you really mean it. 

B filename 

Same as e, but will silently allow you to quit an editing session without warning you if 
you have not written your file, e, on the other hand, reminds you to save your changes if 
you have altered the buffer at all. 

f filename Display Remembered Filename. 

Display the currently ‘remembered filename*. If filename is given, the currently ‘remem¬ 
bered filename’ is changed to filename. 

sfregular expreeeionfoperation Hot 

This is the global operatimi: perform operation Hot on all lines in the range of line- 
addresses containing regular expreeoion. g accepts two line-addresses — default is all 
lines in the buffer. Also see the v operation, which inverts the sense of regular expreesion. 

If your operation Hot actually takes up more than a single line, you must end every line 
except the last (the true ‘end’ of the global operation) with an e 8 cs 4 >e character, ‘\’. For 
example, if you want to nubstitute ‘jimjams’ for ‘frammis’, then append several lines of 
text to every line containing the string ‘widget’ and print those lines, you would type this 
sequence: 

g/widget/s/frammis/jimjams/X 

»\ 

new line of text\ 
another new line of text\ 

A 

p 

Note that the a, 1, and e operations, which put ei in input mode, are permitted in the 
operation lift; the final. terminating input msgr be omitted if it is the last line of the opera¬ 
tion list. The g and v operations are not permitted in the operation list. 

1 Insert Text. 

Insert lines of text into the buffer before the addressed line. I accepts one line-address — 
default line-address is the current line. The current line is placed at the last line input; if 
no text is input, the current line is left at the line before the addressed line. I differs from a 
only in the placement of the text. 

J Join Lines. 

Joins the addressed lines into a single line; intermediate newlines simply disappear. J 
accepts two line-addresses — default is the current line and the following Une. The current 
line is placA at the resulting line. 

kx Mark Line. 

Marks the addressed line with name z (the name must be a lower-case letter). The line- 
address form ' X then addresses this line, k accepts one line-address — default line-address 
is the current line. 

1 Display Non-printing Characters. 

Displays non-graphic characters in the addressed lines such that they are displayed in two- 
digit octal, and long lines are folded. 1 accepts two line-addresses — default line-address is 
the current line. 1 may be placed cm the same line after any non-I/O operation. 

maddreeo Move lines. 

Reposition the addressed lines after the line-addressed by address, m accepts two line- 
addresses to specify the range of lines to be moved — default line-address is the current 
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line. The last of the moved lines becomes the current line, 
p Print (display) Lines. 

Displays the addressed lines, p accepts two line*addresses — default line-address is the 
current line. The current line is placed at the last line printed, p may be placed on the 
same line after any non-I/O operation. 

P Synonym for p. 
q Quit Edit Session. 

Exit from the editing session. Note, however, that the buffer is not automatically written 
out (do a *w’ to write if you want to save your changes). Ed warns you once if you haven’t 
saved your file — a second q says you really mean it, 

Q Same as q, but you don’t get any warning if you haven’t previously written out the buffer. 

r filename Read from file. 

Reads the contents of filename into the buffer after the addressed line. If filename is not 
given, the ^remembered filename’, if any, is used (see e and f). r accepts one line-address — 
default line-address is $. If line-address ’0’ is used, r reads the file in at the beginning of the 
buffer. If the read is successful, r displays the number of characters read in. The current 
line is left at the last line read in from the file. 

%!regular expreeeionf replacement etringj or, 

alregular expressionf replacement stringf^ 

Substitute the' replacement string for the first occurrence of regular expression on each line 

where the regular expression occurs. In the first form of the a operation, only the first 

occurrence of the matched string on each line is replaced. If you use the g (global) suffix, 
aU occurrences of the regular expression are replaced in the line. Keep the g suffix of the s 
operation distinct from the g operation itself — they are completely different, s accepts two 
line-addresses to delimit the range of lines within which the substitutions should be done — 
default line-address is the current line. The current line is left at the last line substituted. 

Special Characters: 

Any punctuation character may be used instead of */* delimit the regular expres¬ 
sion and the replacement string. 

An ampersand *&’ appearing in the replacement string is replaced by the string 

matching the regular expression. The special meaning of in this context may be 

suppressed by preceding it by ‘\’. 

The characters \n where n is a digit, are replaced by the text matched by the n-th 
regular subexpression enclosed between *\(’ and ’\)’. When nested, parenthesized 
subexpressions are present, n is determined by counting occurrences of *\(’ starting 
from the left. Lines may be split by substituting new-line characters into them. 
The new-line in the replacement string must be escaped by preceding it by 

taddress Transfer Lines. 

Transfers a copy of the addressed lines to after line address, transfer is like move, but it 
makes copies of the lines, leaving the original text where it was. t accepts two line- 
addresses preceeding the operation letter — default line-address is default. The current line 
is left on the last line of the copy. ‘0’ is a legal line-address for the destination. 

u Undo. Undo previous substitute. 

undo undoes the effect of the the last substitute operation, providing that the current line 
has not been moved since the substitute operation. 

v/regular expression/operation list 

Like a negative of the global operation, g: perform operation list on all lines except those 
containing regular expression, v accepts two line-addresses — default is all lines in the file. 

w Write Lines. 
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Write the addressed lines from the buffer into the file specified by the 'remembered 
filename’, w accepts two line-addresses — default is all lines in the file. The current line is 
unchanged. If the write is successful, ti displays the number of characters written. 

w filename Write Lines. 

Write the addressed lines into filename. Filename is created if it does not already exist. 
Filename becomes the 'remembered filename’ (see the e and f operations), w accepts two 
line-addresses — default is all lines in the file. The current line is unchanged. If the write 
is successful, ed displays the number of characters written. 

W filename 

Same as w, but appends the addressed lines to the named file instead of overwriting the file. 
W accepts two line-addresses — default is all lines in the file. 

X Encrypt File. 

When X is used, ed demands a key string from the standard input. Later r, e, and w operap 
tions will encrypt and deciypt the text with this key by the algorithm of erypt{l). An expli¬ 
citly empty key turns off encryption. 

as Display Line Number. 

Display the line number of the addressed line, as accepts one line-address — default line- 
address is |. The current line is unchanged by this operation. 

Kahdl eoniinand> 

The remainder of the line after the '!' is sent to 9h{l) to be interpreted as a shell command. 
The current line is unchanged. 

addfcrs<newlliie> 

Display the addressed line. If you type a line-address and type return, ed displays the 
addressed line. If you simply type RETURN, the line following the current line is displayed 
(equivalent to '•+ Ip’). This is useful for stepping through text. 

REGULAR EXPRESSIONS 

Ed supports a limited form of regular expreeeion notation. A regular expression (also known as a 
pattern) specifies a set of strings of characters — such as 'any string containing digits 5 through 
Q’ or 'only lines containing uppercase letters’. A member of this set of strings is said to be 
matched by the regular expression. Regular expressions or patterns are used to address lines in 
the buffer (see Line Addressing, above), and also for selecting strings to be substituted in the • 
(substitute) operation described previously. 

An empty regular expression, indicated by two regular expression delimiters in a row, stands for a 
copy of the last regular expression encountered. 

Any given regular expression matches the the longest among the leftmost matches in a line. 

In the following specification for regular expressions, the notation C stands for any single ordinary 
character, where a character is anything except a newline character. 

e any ordinary character except a special character matches itself. Special characters are 
the delimiters that actually surround the regular expression, plus \ (the escape character), 
[ (the opening bracket for a character class as described below), • (period which matches 
any single character), and sometimes the (closure) " and $ characters. If you want a 
literal occurrence of one of these special characters you must escape them with the \ 
character. « 

at the very start of the regular expression constrains the match to the beginning of the 
line. A match of this type is called an 'anchored match’ because it is 'anchored’ to a 
specific place in the line. The " character loses its special meaning if it appears in any 
position other than at the very start of the regular expression. 

$ at the very end of the regular expression constrains the match to the end of the line. A 
match of this type is called an 'anchored match’ because it is 'anchored’ to a specific 




ED(1) 


USER COMMANDS 


ED(1) 


place in the line. The $ character loses its special meaning if it appears in any position 
other than at the very end of the regular expression. 

• (period) matches any single character except a newline character. 

\9iring\ A string of characters enclosed in brackets matches any one of the characters in the 
brackets. For example, (abcxyz] matches any single character from the set ^abcxyz^ If 
the first character inside the bracket is a ", the string matches any character not inside 
the brackets. For instance, ("456787] matches any character except ^45678’. You can 
use a shorthand notation to refer to an inclusive rangt of characters: a-b. Such a brack* 
eted string of characters is known as a character class. 

When two regular expressions are concatenated, they match the leftmost and then the 
longest possible string that can be divided with the first part of the string matching the 
first regular expression, followed by the second string matching the second regular expres¬ 
sion. 

® Any regular expression followed by * matches a sequence of 0 or more matches of the reg* 
ular expression. Such a pattern is called a closure. For example: (a-sj [a-zj* matches 
any string of one or more lower case letters. 

\( regular expression\) 

The regular expression within the \( and \) brackets essentially ‘remembers’ whatever the 
regular expression matches. This provides a mechanism for extracting parts of strings. 
There can be up to nine such partial matches in a string. Parenthesized regular 
expressions can be nested. 

\ n where n is in the range 1 thru 9, matches a copy of the string that the bracketed regular 
expression beginning with the nth \( matched, as described in the previous paragraph on 
matching parts of strings. When nested, parenthesized subexpressions are present, n is 
determined by counting occurrences of \( starting from the left. 

Regular expressions are used in line-addresses to specify lines and in one operation (see s for sub¬ 
stitute above) to specify a portion of a line which is to be replaced. If it is desired to use one of 
the regular expression metacharacters as an ordinary character, that character may be preceded 
by ‘\’. This also applies to the character bounding the regular expression (often 70 ^ A* 

itself. 

FILES 

/tmp/e* 

ed.hup; work is saved here if telephone hangs up 

SEE ALSO 

Using the edLine Editor in Editing and Text Processing on the Sun Workstation. 

crypt(l) encode and decode 

ex(l) extended line editor (part of w) 

sed(i) stream editor 

vi(l) visual (display) editor 

BUGS 

The 1 operation mishandles DEL. 

The undo operation removes marks from affected lines. 

Because 0 is an illegal line-address for a w operation, it is not possible to create an empty file with 
ed. Use ca((l) to create an empty file, 

RESTRICTIONS 

Some size limitations: 512 characters per line, 256 characters per global command list, 64 charac¬ 
ters per file name, and'128K characters in the temporary file. Since each line uses two bytes of 
memory, the limit on the number of lines should not be exceeded in practice. 
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When reading a file, ed discards ASCII NUL characters and all characters after the last newline, ed 
refuses to re^ files containing non*AScn characters. 

The encryption facilities of td are not available on software shipped outside the U.S. 
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NAME 

eqn, neqn, checkeq - typeset mathematics 
SYNOf^SIS 

eqn ( -dzy ) ( -pn ) ( -nn ] ( -fn ) ( file ) ... 
checkeq [ file ] ... 

DESCRIPTION 

Eqn (and neqn) are language processors to assist in describing equations. Eqn is a preprocessor for 
trojB{l) and is intended for devices that can print troffs output. Neqn is a preprocessor for 
nroj^l) and is intended for use with terminals. Usage is almost always: 
tutorial% eqn file ... | troff 
tutoriaI% eqn file ... \ nroff 

If no ^es are specified, eqn and neqn read from the standard input. A line beginning with ^EQ’ 
marks the start of an equation; the end of an equation is marked by a line beginning with '.EN’. 
Neither of these lines is altered, so they may be defined in macro packages to get centering, 
numbering, etc. It is also possible to set two characters as ‘delimiters’; subsequent text between 
delimiters is also treated as eqn input. 

Checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 


OPTIONS 

--dzy Set equation delimiters may be set to characters z and y with the command-line argu¬ 
ment. The more common way to do this is with ‘delim zy' between .EQ and .EN. The 
left and right delimiters may be identical. Delimiters are turned off by ‘delim off’ appear¬ 
ing in the text. All text that is neither between delimiters nor between .EQ and .EN is 
passed through untouched. 

-pn Reduce subscripts and superscripts by n point sizes from the previous size. In the 
absence of the -p option, subscripts and superscripts are reduced by 3 point sizes from 
the previous size. 

-an Change point size to n globally in the document. The point size can abo be changed glo¬ 
bally in the body of the document by using the gsixe directive. 

-'fn Change font to n globally in the document. The font can also be changed globally in the 
body of the document by using the gfont directive. 


EQN LANGUAGE ; L 

Tokens within eqn are separated by spaces, tabs, newlines, braces, double quotes, tildes or 
circumflexes. Braces {} are used for grouping; generally speaking, anywhere a single character 
like z could appear, a complicated construction enclosed in braces may be used instead. Tilde (") 
represents a full space in the output, circumflex (") half as much. 


Subscripts and superscripts are produced with the keywords sub and sup. Thus z eub i makes 2 ;,, 
a 8ub i 8up S produces a,^, and e eup {z sup 2 + y sup 2} gives e® . 


Fractions are made with over: a over b yields 


sqrt makes square roots: 1 over sqrt {az sup 2 + bz+ c} results in - . 

n 

The keywords from and to introduce lower and upper limits on arbitrary things: lim is 

n-^oo Q 

made with lim from {n-> inf } sum from 0 to n z sub i. 

Left and right brackets, braces, etc., of the ri^t height are made with left and right: left [ z sup 


2 y dtip 2 over alpha right 1 produces 




jl 

a 


= 1. The right clause is optional. Legal 


characters after left and right are braces, brackets, bars, c and f for ceiling and floor, and ”” for 
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nothing at all (useful for a right-side-only bracket). 

Vertical piles of things are made with pile, IpUe, cpUe, and rpUe: pile {a above b above c} pro- 
a 

duces b. There can be an arbitrary number of elements in a pile. Iplle left-justifies, pile and 
c 

cpUe center, with different vertical spacing, and rplle right justifies. 

Matrices are made with matrix: matriz { leot { x eub i above p tub S} eeol { 1 above S) } pro- 
», 1 

duces „ A. In addition, there is reol for a right-justified column. 

If2 ^ 

Diacritical marks are made with dot, dotdot, hat, tilde, bar, vee, dyad, and under: x dot = 
f(t) bar is *=/(<), y dotdot bar n under is y = jb, and x vee ~=~ y dyad is ? = If. 

Sizes and font can be changed with slxe n or size ± n, roman, ttaUe, bold, and font n. Size 
and fonts can be changed globally in a document by gslse n and gfont n, or by the command¬ 
line arguments -sn and -fn. 

Successive display arguments can be lined up. Place mark before the desired lineup point in the 
first equation; place lineup at the place that is to line up vertically in subsequent equations. 

Shorthsmds may be defined or existing keywords redefined with define; 
define thing % replacement % 

defines a new token called thing which will be replaced by replacement whenever it appears 
thereafter. The % may be any character that does not occur in replacement. 

Keywords like oum (J^), int (J), inf (oo), and shorthands like >■■ (>), -> (-►), and !*■ (j^) are 
recognized. Greek letters are spelled out in the desired case, as in odpha or GAMMA. Mathemati¬ 
cal words like sin, cos, log are made Roman automatically. troS(\) four-character escapes like 
\(bu (•) can be used anywhere. Strings enclosed in double quotes ”...” are passed through 
untouched; this permits keywords to be entered as text, and can be used to communicate with 
trofi when all else fails. 

SEE ALSO 

troff(l), tbl(l), ms(7), eqnchar(7) 

Typesetting Mathematics with ’eqn ’ and 

Formatting Documents with ‘nroff’ and ‘troffi 

in Editing and Text Processing on the Sun Workstation. 

BUGS 

To embolden digits, parens, etc., it is necessary to quote them, as in 'bold ”12.3’”. 
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NAME 

error - analyze and disperse compiler error messages 
SYNOPSIS 

error ( -n ) { -« | ( -q ) | -v ) j -t suffixliet ) [ -I ignorefiie ] ( name ) 

DESCRIPTION 

Error analyzes error messages produced by a number of compilers and language processors. It 
replaces the painful, traditional methods of scribbling abbreviations of errors on paper, and per¬ 
mits error messages and source code to be viewed simultaneously. 

Error looks at error messages, either from the specified file name or from the standard input, and: 

• Determines which language processor produced each error message, 

• Determines the file name and line number of the erroneous line, and, 

• Inserts the error message into the source file immediately preceding the erroneous line. 

Error messages which can’t be categorized by language processor or content are not inserted into 
any file, but are sent to the standard output. Error touches source files only after all input has 
been read. 

Options are explained later on in this manual entry. 

Error is intended to be run with its standard input connected via a pipe to the error message 
source. Some language processors put error messages on their standard error file; others put their 
messages on the standard output. Hence, both error sources should be piped together into error. 
For example, when using the coh syntax, 

tutoriaI% m&ka -s lint | A error -q -v 

will analyze all the error messages produced by whatever programs make runs when making lint. 

Error knows about the error messages produced by: make, ce, cpp, ccom, aa, Id, lint, pi, pc, and 
/77. For all languages except Pascal, error messages are restricted to one line. Some error mes¬ 
sages refer to more than one line in more than one file, in which case error duplicates the error 
message and inserts it at all of the places referenced. 

Error does one of six things with error messages. 
synchronize 

Some language processors produce short errors describing which file they are processing. 
Error uses these to determine the file name for languages that don’t include the file name 
in each error message. These synchronization messages are consumed entirely by error. 

discard Error messages from lint that refer to one of the two lint libraries, fuarfliblllib-lc and 
luarfUbfllib-port are discarded, to prevent accidently touching these libraries. Again, 
these error messages are consumed entirely by error. 

nullify Error messages from lint can be nullified if they refer to a specific function, which is 
known to generate diagnostics which are not interesting. Nullified error messages are not 
inserted into the source file, but are written to the standard output. The names of func¬ 
tions to ignore are taken from either the file named .errorrc in the user’s home directory, 
or from the file named by the —I option. If the file does not exist, no error messages are 
nullified. If the file does exist, there must be one function name per line. 

not file specific 

Error messages that can’t be intuited are grouped together, and written to the standard 
output before files are touched. They are not inserted into any source file. 

file specific 

Error messages that refer to a specific file but to no specific line are written to the stan¬ 
dard output when that file is touched. 

true errors 
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Error messages that can be intuited are candidates for insertion into the file to which they 
refer. 

Only true error messages are inserted into source files. Other error messages are consumed 
entirely by error or are written to the standard output. Error inserts the error messages into the 
source file on the line proceeding the line number in the error message. Each error message is 
turned into a one line comment for the language, and is internally flagged with the string '###' 
at the beginning of the error, and '%%%' at the end of the error. This makes pattern searching 
for errors easier with an editor, and allows the messages to be easily removed. In addition, each 
error message contains the source line number for the line the message refers to. A reasonably 
formatted source program can be recompiled with the error messages still in it, without having 
the error messages themselves cause future errors. For poorly formatted source programs in free 
format languages, such as C or Pascal, it is possible to insert a comment into another comment, 
which can wreak havoc with a future compilation. To avoid this, format the source program so 
there are no language statements on the same line as the end of a comment. 

OPTIONS 

-n Do not touch any files; all error messages are sent to the standard output. 

-q Error asks whether the file should be touched. A ‘y* or 'n’ to the question is necessary to 
continue. Absence of the -q option implies that all referenced files (except those refering to 
discarded error messages) are to be touched. 

After all files have been touched, overlay the visual editor vi with it set up to edit all files 
touched, and positioned in the first touched file at the first error. If vi can’t be found, try ez 
or ed from standard places. 

-t Take the following argument as a suffix list. Files whose suffices do not appear in the suffix 
list are not touched. The suffix list is dot seperated, and wildcards work. Thus the 
suffix list: 

’’.c.y.f*.h” 

allows error to touch files ending with *.c', *.y’, *.f*’ and *.y’. 

-a Print out etatiotieo regarding the error categorization. Not too useful. 

Error catches interrupt and terminate signals, and if in the insertion phase, will orderfy terminate 
what it is doing. 

FILES 

'/.errorrc function names to ignore for tint error messages 

/dev/tty user’s teletype 

BUGS 

Opens the teletype directly to do user querying. 

Source files with links make a new copy of the file with only one link to it. 

Changing a language processor’s format of error messages may cause error to not understand the 
error message. 

Error, since it is purely mechanical, will not filter out subsequent errors caused by 'floodgating’ 
initiated by one syntacticsdly trivial error. Humans are still much better at discarding these 
related errors. 

Pascal error messages belong after the lines affected (error puts them before). The alignment of 
the ' I ’ marking the point of error is also disturbed by error. 

Error was designed for work on CRT’s at reasonably high speed. It is less pleasant on slow speed 
terminals, and has never been used on hardcopy terminals. 
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NAME 

ex, edit - text editor 
SYNOPSIS 

ex (- 1 ( -V 1 I -t tag 1 I -p 1 ( +eoTnmand ] [ -1) name ... 
edit [ ex options ] 

DESCRIPTION 

Ex is the root of a family of editors which includes edt<(l), ex, and v»(l). Display based editing is 
the focus of vi. Most users will in fact use vi as the principal interface to the system rather than 
ex. 


OPTIONS 

- supress ail interactive feedback to the user — useful for processing ex scripts in shell files. 

-V start up in display editing state using vt(l). You can achieve the same effect by simply 

typing the vi command itself. 

-t tag edit the file containing the tag tag. A tags database must have been built previously 
using the clay 9 (l) command. 

—r recover the indicated files after a crash. 

-1 set up for editing LISP programs. 

-wnnn set the default window (number of lines on your terminal) to nnn— this is useful if you 
are dialing into the system over a slow ’phone line. 

-X - prompt for a key to be used in encrypting the file being edited. 

-R edit the file in read-only state. You can achieve the same effect with the view command. 
-I-command 

start the editing session by executing command. 


DOCUMENTATION 

The document Edit: A tutorial provides a comprehensive introduction to edit assuming no previ¬ 
ous knowledge of computers or the UNIX system. 


The Ex Reference Manual - Veroion S.5 is a comprehensive and complete manual for the com¬ 
mand mode features of ex, but you cannot learn to use the editor by reading it. For an introduc¬ 
tion to more advanced forms of editing using the command mode of ex see the editing documents 
written by Brian Kernighan tor the editor ed; the material in the introductory and advanced 
documents works also with ex. 

;fr> 

An /ntraduction to Display Editing with Vi introduces the display editor vi and provides reference 
material on vi. These documents can be found in the Editing and Text Processing Manual. In 
addition, the Vi Quick Reference card summarizes the commands of vi in a useful, functional way, 
and is useful with the Introduction. 


FILES 

/u8r/lib/ex?.?strings 

/usr/lib/exT.Trecover 

/usr/lib/exf.Tpreserve 

/etc/termcap 

“/.exrc 

/tmp/Exnnnnn 

/tmp/Rxnnnnn 

/usr/preserve 


error messages 

recover command 

preserve command 

describes capabilities of terminals 

editor startup file 

editor temporary 

named buffer temporary 

preservation directory 


SEE ALSO 

awk(l), ed(l), grep(l), sed(l), grep(l), vi(l), termcap(5), environ(5) 


Sun Releasp 1.1 


Last change: 13 March 1984 


113 






EX(1) 


USEK COMMANDS 


EX(1) 


BUGS 

The undo command causes all marks to be lost on lines changed and then restored if the marked 
lines were changed. 

Undo never clears the buffer modified condition. 

The z command prints a number of logical rather than physical lines. More than a screen full of 
output may result if long lines are present. 

Ffle input/output errors don’t print a name if the c<Hnmand line *—* option b used. 

There b no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used before exiting the editor. 
Null characters are discarded in input files, and cannot ^pear in resultant files. 

RESTRICTIONS 

The encryption facilities of ex are not available on software shipped outside the U.S. 
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NAME 

expand, unexpand - expand tabs to spaces, and vice versa 
SYNOPSIS 

fxpand I -tabstop j {-tabl,tab2,...,tabn ]{ file ... ] 
unexpand [ -a ] ( file ... ] 

DESCRIPTION 

Expand copies the named files (or the standard input) to the standard output, with tabs changed 
into spaces (blanks). Backspace characters are preserved into the output and decrement the 
column count for tab calculations. Expand is useful tor pre-processing character files (before sort¬ 
ing, looking at specific columns, etc.) that contain tabs. 

Unexpand copies the named files (or the standard input) to the standard output, putting tabs back 
into the data. By default only leading spaces (blanks) and tabs are converted to strings of tabs, 
but this can be overridden by the -a option (see the options section below). 

EXPANQ OPTIONS 
-tabstop 

Specified as a single argument sets tabs tabstop spaces apart instead of the default 8. 

-tabl,tab2|.. .,tabn 

Set tabs at the columns specified by tab!,,, 

UNEXPAND OPTIONS 

-a Insert tabs when replacing a run of two or more spaces would produce a smaller output 
file. This option only applies to unexpand. 


o 
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NAME 

expr - evaluate arguments as an expression 

SYNOPSIS 

expr arg *.. 

DESCRIPTION 

Expr evaluates expressions as specified by its arguments. Each token of the expression is a 
separate argument. After evaluation, the result is written on the standard output. 

The operators and keywords are listed below. The list is in order of increasing precedence, with 
equal precedence operators grouped. 

expr I expr 

yields the first expr if it is neither null nor 'O’, otherwise yields the second expr. 
expr & expr 

yields the first expr if neither expr is null or *0’, otherwise yields 'O’, 
expr retop expr 

yields if the indicated comparison is true, 'O’ if false. The comparison is numeric if 
both expr are integers, otherwise the comparison is lexicographic, relop is one of < (less 
than), <» (less than or equal to), = (equal to), != (not equal to), >» (greater than or 
equal to), and > (greater than). 

expr d- expr 
expr - expr 

addition or subtraction of the arguments. 

expr * expr 
expr / expr 
expr % expr 

multiplication, division, or remainder of the arguments, 
expr : expr 

match etring regular-expression 

The two forms of the matching operator above are synonymous. The matching operator 
compares the string first argument with the regular expression second argument; regular 
expression syntax is the same as that of ed(l). The \(«..\) pattern symbols can be used 
to select a portion of the first argument. Otherwise, the matching operator yields the 
number of characters matched ('O’ on failure). 

substr string integer-! integer-2 

extracts the subtring of string starting at position integer-1 and of length tn^eper-f char¬ 
acters. If integer-1 has a value greater than siring, expr returns a null string. If you try 
to extract more characters than there are in string, expr returns all the remaining charac¬ 
ters from string. Beware of using negative values for either integer-1 or integer-2 as expr 
tends to run forever in these cases. 

length string 

returns the length (that is, the number of characters) of string, index string character-list 
reports the first position in string at which any one of the characters in character-list 
matches a character in string. 

( expr ) parentheses for grouping. 

EXAMPLES 

To add 1 to the Shell variable a: 
a—'expr $a + 1' 
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Jo find the filename part (least significant part) of the pathname stored in variable a, which may 
pr magr. not contain 

expr $a:'.*/\(**\)' 
l^ote the quoted SheO metacharacters. 

SEE ALSO 

te8t(l) 

DIAGNqljSTICS 

^xpr returns the following exit codes; 

0 if the expression is neither null nor ‘O’, 

1 if the expression is null or ‘O’, 

2 for invalid expressions. 

BUGS 

Note that the match, substr, length, and Index operators cannot themselves be used as ordi¬ 
nary strings. That is, the expression: 

tutorial^ expr Index expurgatorlous length 

syntax error 

tutorial^ 

generates the ‘syntax error* message as shown instead of the value 1 as you might expect. 
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NAME 

eyacc - modified yacc allotving much improved error recovery 
SYNOPSIS 

eyaee (-v | ( grammar ] 

DESCRIPTION 

Eyaee is an old version of ysce(l), which produces tables used by the Pascal system and its error 
recovery routines. Eyaee fully enumerates test actions in its parser when an error token is in the 
iook>ahead set. This prevents the parser from making undesirable reductions when an error 
occurs before the error is detected. The table format is different in eyaee than it was in the old 
yaee, as minor changes had been made for efficiency reasons. 

SEE ALSO 

yacc(l) 

Praetieal LR Error Reeovery by Susan L. Graham, Charles B. Haley and W. N. Joy; SIGPLAN 
Conference on Compiler Construction, August 1979. 

BUGS 

Pe and its error recovery routines should be made into a library of routines for the new yaee. 
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NAME 

f77 - FORTRAN-77 compiler 
SYNOPSIS 

f77 ( -c I (-g 1 (-w ) ( -p 1 (-pg 1 ( -O 1 (-S ) ( -R ) I -fsky ) (-o output ) ( -onetrlp ) 

[ -u J I -C 1 ( -F ] ( -m 1 I -R X ] ( -N[qxKn] nnn } file . .. 

DESCRIPTION 

F77 is the UNDC FORTRAN-77 compiler for translating programs written in the FORTRAN-77 pro¬ 
gramming language into executable load modules or relocatable binary programs for subsequent 
loading via the /(f(l) linker. In addition to the many flag arguments (options), /77 accepts several 
types of files: 

Filenames ending in ./ are taken to be FORTRAN-77 source programs; they are compiled, and 
each object program is left in the file in the current directory whose name is that of the source 
with .0 substituted for •/. Filenames ending in .F are also taken to be FORTRAN-77 source pro¬ 
grams, but they are preprocessed by the C preprocessor (equivalent to a ce —E) before they are 
compiled by the /77 compiler. 

Filenames ending in .r are taken to be Ratfor source programs; these are first transformed by the 
appropriate preprocessor, then compiled by /77. 

In the same way, filenames ending in .c or .« are taken to be C or assembly source programs and 
are compiled or assembled, producing a .o file. 

OPTIONS 

The following options have the same meaning as in cc(l). See /(f(l) for load-time options. 

-e Suppress loading and produce ,o files for each source file. 

-g Produce additional symbol table information for dix(l). Also pass the -Ig flag to /(f(l). 

-w Suppress all warning messages. If the option is -wOO, only FORTRAN-S8 compatibility 
warnings are suppressed. 

-Dname*adef 

-Dnsme 

Define the name to the C preprocessor, as if by ‘#deflne’. If no definition is given, the 
name is defined as ”1”. (.F suffix files only). 

—Idir ‘#include’ flies whose names do not begin with are always sought first in the directory 
of the file argument, then in directories named in -I options, then in directories on a stan¬ 
dard list. (.F suffix files only). 

-p Prepare object files for profiling, see profil). 

-pg Produce counting code in the manner of -p, but invoke a run-time recording mechanism 
that keeps more extensive statistics and produces a gmon.out file at normal termination. 
An execution profile can then be generated by use of gprofil). 

-O Optimize the object-code. 

—S Compile the named programs, and leave the assembler-language output on corresponding 

files suffixed ,»(no .o file is created). 

-o output 

Name the final output file output instead of a.out. 

-fsky Generate code which assumes the presence of a SKY floating-point processor board. Pro¬ 
grams compiled with this option can only be run in ^sterns that have a SKY board 
installed. Programs compiled without the —fsky option will use the SKY board, but 
won’t run as fast as they would if the -fsky option were used. If any part of a program 
is compUed using the -fsky option^ you must also use this option when linking with the 
/77 command, since a different set of startup routines is used. 
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The following options are peculiar to /77: 

—12 On machines which support short integers, make the default integer constants and vari¬ 
ables short. (-14 is the standard value of this option). All logical quantities will be short. 

-m Apply the M4 preprocessor to each .r file before transforming it with the Ratfor prepro¬ 
cessor. 

-onetrlp 

Compile DO loops that are performed at least once if reached. FORTRAN-77 DO loops are 
not performed at all if the upper limit is smaller than the lower limit. 

-u Make the default type of a variable 'undefined' rather than using the default FORTRAN 
rules. 

-V Print the version number of the compiler, and the name of each pass as it executes. 

-C Compile code to check that subscripts are within declared array bounds. 

-F Apply the C or Ratfor preprocessor to relevant files, put the result in the file with the 
suffix changed to ./, but do not compile. 

—Rz Use the string 2 as a Ratfor option in processing .r files. 

-N[qx8en]nnn 

Make static tables in the compiler bigger. F77 complains if tables overflow and suggests 
you apply one or more of these flags. These flags have the following meanings: 

q Maximum number of equivalenced variables. Default is 150. 

X Maximum number of external names (common block names, subroutine and func¬ 

tion names). Default is 200. 

8 Maximum number of statement numbers. Default is 401. 

e Maximum depth of nesting for control statements (for example, DO loops). 

Default is 20. 

n Maximum number of identifiers. Default is 1009. 

-U Do not convert upper case letters to lower case. The default is to convert FORTRAN pro¬ 
grams to lower case except within character string constants. 

Other arguments are taken to be either loader option arguments, or F77-compatible object pro¬ 
grams, typically produced by an earlier run, or perhaps libraries of F77-compatible routines. 
These programs, together with the results of any compilations specified, are loaded (in the order 
given) to produce an executable program called a.out. 

FILES 

file.|fFrsc] 
file.o 
a.out 

./fort(pid).? 

/usr/lib/f77passl 
/lib/fl 
/lib/c2 
/lib/cpp 
/usr/lib/libf77.a 
/lib/Ubc.a 
mon.out 
gmon.out 

SEE ALSO 

FORTRAN Programmer *8 Guide for the Sun Workstation, 

P'Slrtl)* W(l). ratfor(l) 


input file 
object file 
loaded output 
temporary 
compiler 
pass 2 

optional optimizer 

C preprocessor 

Fortran library 

C libra^, see section 3 

file produced for analysis by prof(l). 

file produced for analysis by gprof(l). 
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DIAGNOSTICS 

The diagnostics produced by /77 itself are intended to be self-explanatory. Occasional messages 
may be produced by the loader. 

BUGS 

The FORTRAN-68 subset of the language has been exercised extensively; the newer features have 
not. 
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NAME 


false, true - provide truth values 


SYNOPSIS 

^rue 

false 


DESCRIPTION 

True and falte are usual^ used in a Bourne shell script. They test for the appropriate status 
"true” or ’’false” before running (or failing to run) a list of commands. 

EXAMPLE 


while false 
do 

command list 
done 

SEE ALSO 

C8h(l), sh(l), true(l) 

DIAGNOSTICS 

Falee has exit status nonzero. 


W' 
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NAME 

file - determine file type 

SYNOPSIS 

file file... 

DESCRIPTION 

file performs a series of tests on each file in an attempt to determine what its contents are. If an 
argument appears to be ASCII, file examines the first 512 bytes and tries to guess its language. 

EXAMPLE 

The example illustrates the use of file on all the files in a specific user’s directory: 


% pwd 




/usr/henry/misc 



%b 




bensusan 

fortran.mss messages 

romero 

toolklt.tr 

command.list 

jokes pascal.mss 

squash 

usefulnews 

counts 

letters . play.mss 

tech.papers 

v7.8tuff 

deuter 

memos roadmap.mss 

titles 

window 

%flle ♦ 




bensusan: 

roff, nroff, or eqn input text 



command.list: 

roff, nroff, or eqn input text 



counts: 

ascii text 



deuter: 

roff, nroff, or eqn input text 



fortran.mss: 

roff) nroff, or eqn input text 



jokes: 

directory 



letters: 

directory 



memos: 

directory 



messages: 

directory 



pascal.mss! 

roff, nroff, or eqn input text 



play.mss: 

roff) nroff, or eqn input text 



roadmap.mss: 

Tott, nroff, or eqn input text 



romero: 

roff, nroff, or eqn input text 



squash: 

directory 



tech.papers: 

directory 



titles: 

ascii text 



toolkit.tr: 

roff, nroff, or eqn input text 



useful.news: 

directory 



v7.8tuff: 

archive 



window: 

directory 




% 

BUGS 

It often makes mistakes. In particular it often suggests that command files are C programs. 
Does not recognize Pascal or LISP. 
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NAME 

^nd - find files 
SYNOPSIS 

Qnd pathname-list expression 
DESCRIPTION 

Ftnd recursively descends the directory hierarchy for each pathname in the pathname-list (that is, 
one or more pathnames) seeking files that match a boolean expression written in the primaries 
given below. In the descriptions, the argument n is used as a decimal integer where n means 
more than n, -n means less than n, and n means exactly n. 

-name filename 

True if the filename argument matches the current file name. Normal Shell argument 
syntax may be used if escaped (watch out for and 

-perm onum 

True if the file permission fiags exactly match the octal number onum (see cAmod(l)). 
K onum is prefixed by a minus sign, more flag bits (017777, see stat{2)) become 
significant and the flags are compared: (fiags&onum)^=^onum. 

-type c True if the type of the file is c, where c is b, df f or 1 for block special file, charac¬ 
ter special file, directory, plain file, or symbolic link. 

-links n True if the file has n links. 

-user uname 

True if the file belongs to the user uname (login name or numeric user ID). 

-group gname 

True if the file belongs to group gname (group name or numeric group ID). 

-slse n True if the file is n blocks long (512 bytes per block). 

-inum n True if the file has inode number n. 

-atime n True if the file has been accessed in n days. 

-mtlme n True if the file has been modified in n days. 

-exec command 

True if the executed command returns a zero value as exit status. The end of the 
command must be punctuated by an escaped semicolon. A command argument '{}’ is 
replaced by the current pathname. 

-ok command 

Like -exec except that the generated command is written on the standard output, 
then the standard input is read and the command executed only upon response y. 

-print Always true; the current pathname is printed. 

-newer file 

True if the current file has been modified more recently than the argument file. 

The primaries may be combined using the following operators (in order of decreasing precedence): 

1) A parenthesized group of primaries and operators (parentheses are special to the Shell and 
must be escaped). 

2) The negation of a primary (1* is the unary not operator). 

3) Concatenation of primaries (the and operation is implied by the juxtaposition of two pri¬ 
maries). 

4) Alternation of primaries (‘-o’ is the or operator). 
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EXAMPLE 

In our local development system, we keep a file called TIMESTAMP in all the manual page direc¬ 
tories. Here is bow to find all entries that have been updated since TIMESTAMP was created: 
angel% find /usr/man/manfi -newer /usr/man/manS/TIMESTAMP -print 
/usr/man/man2 
/usr/man/man2/socket.2 
/usr/man/man2/mmap.2 
angel% 

‘Pp find all the files called intro.mss starting from the current user’s directory: 
angel% find . -name lntro.mu -print 
./manuals/assembler/intro.mss 
./manuals/sun.core/intro.mss 
./manuals/driver.tut/intro.mss 
./manuals/users.guide/intro.mss 
./manu als/refman/intro.mss 
./manuals/sys.manager/intro.mss 
./manuals/sys.manager/uucp.impl/intro.mss 
./supplements/general.works/unix.introduction/intro.mss 
./supplements/programming.tools/sccs/intro.mss 
angel% 

To remove aU files named ’a.oot’ or ‘*.o’ that have not been accessed for a week: 

angel% find / \( -name a.out -o -name \) -atlme +7 -exec rm ’{}’ \{ 
angel% 

Note that the { } characters must be quoted when using the C shell. 

FILES 

/etc/passwd 

/etc/group 

SEE ALSO 

sh(l), test(l), f8(5) 

BUGS 

The syntax is painful. 


Sun Release I.l 


Last change: 3 April 1983 


125 






FMT(l) 


USER COMMANDS 


FMT(l) 


NAME 

fmt - simple text formatter 

SYNOPSIS 

fknt I file ... ] 

DESCRIPTION 

Fmt is a simple text formatter which reads the concatenation of inpat files (or standard input if 
none are given) and produces on standard output a version of its input with lines as close to 72 
characters long as possible. The spacing at the beginning of the input lines is preserved in the 
output, as are blank lines and interword spacing. 

Fmt is meant to format mail messages prior to sending, but may also be useful for other simple 
tasks. For instance, in the vt text editor, the command: 

!}fmt 

reformats a paragraph, making the lines reasonably even length. 

SEE ALSO 

nroff(l), mail(l) 

BUGS 

Fmt was designed to be simple and fast - for more complex operations, the standard text proces¬ 
sors are likely to be more appropriate. 
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NAME 

fold - fold long lines for finite width output device 
SYNOPSIS 

fold [-width ] ( file ... ] 

DESCRIPTION 

Fold is a filter which folds the contents of the specified files, or the standard input if no files are 
specified, breaking the lines to have maximum width width. The default for width is 80. Width 
spould be a multiple of 8 if tabs are present, or the tabs should be expanded using expand{l) 
before using fold. 

SEE AL$P 

expand(l)^ 

BUGS 

Folding may not work correctly if underlining is present. 


o 
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NAME 

fpr - print Fortran file 

SYNOPSIS 

tpr 

DESCRIPTION 

Fpr is a filter that transforms files formatted according to Fortran’s carriage control conventions 
into files formatted according to UNDC line printer conventions. 

Fpr copies its input onto its output, replacing the carriage control characters with characters that 
wiU produce the intended effects when printed using (pr(l). The first character of each line deters 
n^ines the vertical spacing as follows: 

(blank) one line 
Q two lines 
1 to first line of next page 
no advance 

A blank line (that is, an empty line) is treated as if its first character is a blank. A blank that 
appears as a carriage control character is deleted. A zero is changed to a newline. A one is 
changed to a form feed. The effects of a ”-1- ” are simulated using backspaces. 

Note that fpr is known as asa in UNIX System V. 

EXAMPLES 

a.out I fpr I Ipr 

fpr < rr?.output I Ipr 

BUGS 

Results are undefined for input lines longer than 170 characters. 
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NAME 

from - who is my mail from? 
SYNOPSflS 

flfom ( -^tender ] ( user ] 


DESCRVTION 

i?rom prints out the mail header lines in your mailbox file to show you who your mail is from. If 
mftr is specified, then user’s mailbox is examined instead of your own. 


OPTIONS 

-fttnder 

Only display headers for mail sent by sender. 

FILES 

/^sr/spool/mail/* 

SEE ALSO 

b^(l), mail(l), prmail(l) 


o 
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NAME 

fsplit - split a multi-routine Fortran file into individual files 

SYNOPSIS / 

fsplit [ —e cflle) ... I file | ! 

DESCRIPTION 

Fsplit takes as input either a file or standard input containing Fortran source code. It attempts 
to split the input into separate routine files of the form namt.f, where name is the name of the 
program unit (e.g. function, subroutine, block data or program). The name for unnamed block 
data subprograms has the fonn hlkdtaNNNJ ynhtxt NNN is three digits and a file of this name 
does not already exist. For unnamed main programs the name has the form mainNNNJ, If there 
is an error in classifying a program unit, or if name./already exists, the program unit wUl be put 
in a file of the form zzzNNNJ where zzzNNN,/ does not already exist. 

Normal^ each subprogram unit is split into a separate file. When the -e option is used, only the 
specified subprogram units are split into separate files. E.g.: 

fsplit -e readit -e doit prog.f 
will split readit and doit into separate files. 

DIAGNOSTICS 

If names specified via the -c option are not found, a diagnostic is written to standard error, 

BUGS 

Fsplit assumes the subprogram name is on the first noncomment line of the subprogram unit. 
Nonstandard source formats may confuse fsplit 

It is hard to use -e for unnamed main programs and block data subprograms since you must 
predict the created file name. 
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NAME 

ftp - file transfer program 
SYNOPSIS 

-V 1 I -d 1 ( -11 ( -n 1 ( ho»t 1 
DESCRIPTION 

Ftp is the user interface to the ARPANET standard File Transfer Protocol Ftp transfers files to 
and from a remote network site. 

The client host with which ftp is to communicate may be specified on the command line. If this is 
done, ftp immediately attempts to establish a connection to an FTP server on that host; other- 
lyise, ftp enters its command interpreter and awaits instructions from the user. When ftp is awaits 
commands from the user, it displays the prompt “ftp>”. Ftp recognizes the following com- 



!' Invoke a shell on the local machine. 

i^cii Set the file transfer type to network ASCII This is the default type. 

Arrange that a bell be sounded after each file transfer command is completed, 
binary Set the file transfer type to support binary image transfer, 
b^e Terminate the FTP session with the remote server and exit ftp, 
ed remote-directory 

Change the working directory on the remote machine to remote-directory, 

close Terminate the FTP session with the remote server, and return to the command inter¬ 
preter. 

delete remote-file 

Delete the file remote-file on the remote machine, 
debug [ dehug-value ] 

Toggle debugging mode. If an optional debug-value is specified it is used to set the debug¬ 
ging level. When debugging is on, ftp prints each command sent to the remote machine, 
preceded by the string 

dir I remote-directory] j local-file] 

Print a listing of the directory contents in the directory, remote-directory, and, option¬ 
ally, placing the output in local-file. If no directory is specified, the current working 
directory on the remote machine is used. If no local file is specified, output comes to the 
terminal. 

form format 

Set the file transfer form to format. The default format is *‘file”. 
get remote-file ( local-file J 

Retrieve the remote-file and store it on the local machine. If the local file name is not 
specified, it is given the same name it has on the remote machine. The current settings 
for type, form, mode, and otructure are used while transferring the file. 

help I command ] 

Print an informative message about the meaning of command. If no argument is given, 
ftp prints a list of the known commands. 

led [ directory ] 

Change the working directory on the local machine. If no directory is specified, the user’s 
home directory is used. 

la ( remote-directory] [ local-file] 

Print an abbreviated listing of the contents of a directory on the remote machine. If 
remote-directory is left unspecified, the current working directory is used. If no local file 
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is specified, the output is sent to the terminal, 
mode] moie~namt\ 

Set the file transfer mode to mode-name. The default mode is “stream” mode. 

mkdlr directory-name 

Make a ditMtoiy on the remote machine. 

op>en hoof I port ] 

Establish a connection to the specified hoof FTP serrer. An optional port number mio^ be 
supplied, in which case, ftp will attempt to contact an FTP server at that port. If Uie 
aulo-/optn option is on (default), /fp will also attempt to automatically log the user in to 
the FTP server (see below)., 

prompt 

Toggle interactive prompting. Interactive prompting occurs during multiple file transfers 
to allow the user to selectively retrieve or store filesw If prompting is turned off (default), 
any mget or mput will transfer all files. 

put local-file I remote-file ] 

Store a local file on the remote machine. If remote-file is left unspecified, the local file 
name is used in naming the remote file. File transfer uses the current settings for type, 
format, mode, and otrueture, 

pwd Print the name of the current working directory on the remote machine, 
quit A synonym for bye. 
quoteurpi aryg ... 

The arguments specified are sent, verbatim, to the remote FTP server. A single FTP 
reply code is expected in return. 

reev remote-file ( local-file | 

A synonym for get. 

remotehdp { command-name j 

Request help from the remote FTP server. If a command-name is specified it is supplied 
to the server as weO.^ 

rename | from j (fo j 

Rename the file /rum on the remote machine, to the file to. 

rmdlr direeto ry-na me 

Delete a directory on the remote machine. 

»«nd local-file | remote-file] 

A synonym for put. 

status Show the current status ot ftp. 
struct I etruct- name j 

Set the file transfer etructure to etruet-name. By default “stream” structure is used, 
tenex Set the file transfer type to that needed to talk to TENEX machines, 
trace Toggle packet tracing, 
typo] type-name] 

Set the file transfer type to type-name. If no type is specified, the current type is printed. 
The default type is network ASCII. 

user user-name ( password ] | account ] 

Identify yourself to the remote FTP server. If the password is not specified and the 
server requires it, ftp will prompt the user for it (after disabling local echo). If an account 
field is not specified, and the FTP server requires it, the user wUI be prompted for it. 
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Unless ftp is invoked with ‘‘auto-login” disabled, this process is done automatically on ini¬ 
tial connection to the FTP server. 

verbose 

Toggle verbose mode. In verbose mode, all responses from the FTP server are displayed 
to the user. In addition, if verbose is on, when a file transfer completes, statistics regard¬ 
ing the efficiency of the transfer are reported. By default, verbose is on. 

f I command] 

A synonym for help. 

Command arguments which have imbedded spaces may be quoted with quote (”) marks. 

FILE NAMING CONVENTIONS 

Files specified as arguments to ftp commands are processed according to the following rules. 

1) If the file name ”” is specifed, the stdin (for reading) or stdout (for writing) is used. 

2) If the first character of the file name is the remainder of the argument is interpreted 
as a shell command. Ftp then forks a shell, using popcn(3S) with the argument supplied, 
and reads (writes) from the stdout (stdin). If the shell command includes spaces, the 
argument must be quoted; e.g. ‘‘”1 Is -It””. A particularly useful example of this mechan¬ 
ism is: ‘‘dir |more”. 

3) Failing the above checks, local file names are expanded according to the rules used in the 
csA(l). (This is not enabled as multiple file transfers are currently not supported.) 

FILE TRANSFER PARAMETERS 

The FTP specification specifies many parameters which may affect a file transfer. The type may 
be one of “ascii”, “image” (binary), “ebcdic”, and “local byte size” (for PDP-lO’s and PDP-20’8 
mostly). Ftp supports the ascii and image types of file transfer. 

Ftp supports only the default values for the remaining file transfer parameters: mode, form, and 
etruet. 

OPTIONS 

Options may be specified at the command line, or to the command interpreter. 

-V show all responses from the remote server, as well as report on data transfer statistics. 

do not attempt “auto-login” upon initial connection. If auto-login is enabled, ftp checks 
the •netrc file in the user’s home directory for an entry describing an account on the 
remote machine. If no entry exists, ftp uses the login name on the local machine as the 
user identity on the remote machine, and prompts for a password and, optionally, an 
account with which to login. 

—I turn on interactive prompting during mutliple file transfers (unimplemented). 

-d enable debugging. 

BUGS 

Many FTP server implementations do not support experimental operations such as print working 
directory. Aborting a file transfer does not work right; if one attempts this the local ftp will likely 
have to be killed by hand. VAX sites running the BBN FTP server appear to ignore the PORT 
command while indicating complicity; this locks up all file transfers. 
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NAME 

gcore - get core images of ruoning processes 


SYNOPSIS 

^core process>id 


DESCRIPTION 

Gcore creates a core image of each specified process. 

dMl)- 


Such an image can be used with ad((l) or 


FILES 

core.<proces8>id> core images 


BUGS 

Pa ging activity that occurs whOe geore is running may cause the program to become confused. 
For best results, the desired processes should be stopped. 
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NAME 

get - get a versioa of an SCCS file 
SYNOPSIS 

/uar/aecs/get (-r SID ] ( -e eutolf ] ( -I list | (-x list) ( -a seq^no. ] (-k ] (-e | ( -l(p|] ( 

-pI 

I -m 11 -n ) (-811 -b 1 (-g 11 -t 1 file ... 

DESCRIPTION 

Get generates an ASCII text file from each named SCCS file according to the specified option. 
Arguments may be specified in any order, options apply to all named SCCS files. If a directory is 
named, get behaves as though each file in the directory were specified as a named file, except that 
non-SCCS files (last component of the path name does not begin with s.) and unreadable files are 
sflently ignored. If a name of ** is given, the standard input is read; each line of the standard 
il^put is taken to be the name of an SCCS file to be processed. Again, non-SCCS files and unread- 
ai)le files are silently ignored. 

The generated text is normally written into a file called the g-JUe whose name is derived from the 
SCCS file name by sipiply removing the leading b.; (see also FILES, below). 

OPTIONS 

Options are explained below as though only one SCCS file is to be processed, but the effects of any 
option argument applies independently to each named file. 

-r SID The 5CCS /Dentification string (SID) of the version (delta) of an SCCS file to be retrieved. 
Table 1 below shows, for the most useful cases, what version of an SCCS file is retrieved 
(as well as the SID of the version to be eventually created by deUa(\) if the -e option is 
also used), as a function of the SID specified. 

-c cutoff 

Culs^date-time, in the form: YY[MM(DDIHHIMM[SS]]]]] 

No changes (deltas) to the SCCS file which were created after the specified cutoff date¬ 
time are included in the generated ASCII text file. Units omitted from the date-time 
default to 4heir maximum possible values; that is, -c7603 is equivalent to 
•-e750228S35050. Any number of non-numeric characters may separate the various 2 
digit pieces of the cufojf date-time. This feature allows one to specify a cutoff in the 
form: -cn/tft 9:22:25. Note that this implies that one may use the %E% and %\}% 
identification keywords. 

This get is for editing or making a change (delta) to the SCCS file via a subsequent use of 
delta{l), A /uBr/sces/get -e applied to a particular version (SlD) of the SCCS file 
prevents further /uBr/Bces/get -e commands on the same SID until delta is run or the J 
(joint edit) fiag is set in the SCCS file (see admtn(l)). Concurrent use of 
/uBr/sccs/get —e for different SIDs is always allowed. 

If the g-file generated by a /uBr/sccs/get -e is accidentally ruined in the process of 
editing it, it may be regenerated by re-running a get with the -k option in place of the 
-e option. 

SCCS file protection specified via the ceiling, fioor, and authorized user list stored in the 
SCCS file (see aim:n(l)) are enforced when the -e option is used. 

Used with the -e option to indicate that the new delta should have an SID in a new 
branch as shown in Table 1. This option is ignored if the b fiag is not present in the file 
(see admtn(l)) or if the retrieved delta is not a leaf delta. (A leaf delta is one that has no 
successors on the SCCS file tree.) 

Note: A branch delta may always be created from a non-leaf delta. 

A list of deltas to be Included (forced to be applied) in the creation of the generated file. 
The list has the following syntax: 


-b 


-^llist 
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<li8t> <rangc> | <li8t> , <raage> 

<range> SID | SID - SID 

SID, the sees Identification of a delta, may be in any form shown in the ‘SID Specified’ 
column of Table 1. Partial SIDs are interpreted as shown in the ‘SID Retrieved* column 
of Table 1. 

—X list A list of deltas to be excluded (forced not to be applied) in the creation of the generated 
file. See the -1 option for the list format, 

— k Suppress replacement of identification keywords (see below) in the retrieved text by their 

value. The -k option is implied by the -e option. 

-l[p] Write a delta summaiy into an I-file. If -Ip is used, the delta summary is written on the 
standard output and the I-file is not created. See FILES for the format of the I*file. 

-p Write the text retrieved from the SCCS file to the standard output. No g-file is created. 
All output which normally goes to the standard output goes to the standard error file 
instead, unless the —a option is used, in which case it disappears. 

-s Suppress aU output normally written on the standard output. However, fatal error mes> 
sages (which always go to the standard error file) remain unaffected. 

—m Precede each text line retrieved from the SCCS file with the SID of the delta that inserted 

the text line in the SCCS file. The format is: SID, followed by a horizontal tab, followed 
by the text line. 

—n Precede each generated text line with the %M% identification keyword value (see below). 

The format is: %M% value, followed by a horizontal tab, followed by the text line. 
When both the -m and -n options are used, the format is: %M% value, followed by a 
horizontal tab, followed by the -m option generated format. 

-g Do not actually retrieve text from the SCCS file. It is primarily used to generate an l-file^ 
or to verify the existence of a particular SID. 

-t Access the most recently created (*top’) delta in a given release (for example, -rl), or 
release and level (for example, -rl.2). 

—aseg-no. 

The delta sequence number of the SCCS file delta (version) to be retrieved (see sccs^e(5)). 
This option is used by the comi(l) command; it is not a generally useful option, and users 
should not use it. If both the -r and -a options are specified, the -a option is used. 
Care should be taken when using the -a option in conjunction with the -a option, as the 
SID of the delta to be created may not be what one expects. The -r option can be used 
with the -a and -e options to control the naming of the SID of the delta to be created. 

For each file processed, get responds (on the standard output) with the SID being accessed and 
with the number of lines retrieved from the SCCS file. 

If the -e option is used, the SID of the delta to be made appears after the SID accessed and before 
the number of lines generated. If there is more than one named file or if a directory or standard 
input is named, each file name is printed (preceded by a new-line) before it is processed. If the —i 
option is used included deltas are listed following the notation ‘Included’; if the -x option is used, 
excluded deltas are listed following the notation ‘Excluded’. 
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TABLE 1. Determination of SCCS Identification String 


SID* 

-b Option 

Other 

SID 

SID of Delta 

Specified 

Usedt 

Conditions 

Retrieved 

to be Created 

noaet 

no 

R defaults to mR 

mR.mL 

mR.(mL+1) 

none| 

yes 

R defaults to mR 

mR.mL 

mR.mL.(mB+ l).l 

R 

no 

R > mR 

mR.inL 

R.l*** 

R 

no 

R mR 

mR.mL 

mR.(mL+1) 

R 

yes 

R > mR 

mR.mL 

mR.mL.(mB+ l).l 

R 

yes 

R = mR 

mR.mL 

mR.mL.(mB-|- l).l 

R 

- 

R < mR and 

R does not exist 

hR.mL** 

hR.mL.(mB+ l).l 

R 

■” 

Trunk succ.# 
in release > R 
and R exists 

R.mL 

R.mL.(mB+ l).l 

R.L 

no 

No trunk succ. 

R.L 

R.(L+1) 

R.L 

yes 

No trunk succ. 

R.L 

R.L.(mB+ l).l 

R.L 

- 

Trunk succ. 
in release > R 

R.L 

RX.(mB+ l).l 

R.L.B 

no 

No branch succ. 

R.L.B.mS 

R.L.B.(mS+ 1) 

R.L.B 

yes 

No branch succ. 

R.L.B.mS 

R.L.(mB+l).l 

RX.B.S 

no 

No branch succ. 

R.L.B.S 

RX.B.(S+1) 

RX.B.S 

yes 

No branch succ. 

R.L.B.S 

R.L.(mB+ l).l 

R.L.B.S 

- 

Branch succ. 

R.L.B.S 

R.L.(mB+l).l 


‘R*, ‘L*, ‘B*, and ‘S* are the ‘release’, ‘level’, ‘branch’, and ‘sequence’ components of the 
SID, respectively; ‘m’ means ‘maximum’. Thus, for example, ‘R.mL’ means ‘the max¬ 
imum level number within release R’; ‘R.L.(mB+ l).l’ means ‘the first sequence number 
on the ntw branch (that is, maximum branch numl^r plus one) of level L within release 
R*. Note that if the SID specified is of the form ‘R.L’, ‘R.L.B’, or ‘R.L.B.S*, each of the 
specified components muet exist. 

‘hR’ is the highest existing release that is lower than the specified, nonexistent, release R. 
Forces creation of the first delta in a new release. 

Successor. 

The -b option is effective only if the b flag (see admm(l)) is present in the file. An entry 
of - means ‘irrelevant’. 

This case applies if the d (default SID) flag is not present in the file. If the d flag is 
present in the file, the SID obtained from the d flag is interpreted as if it had been 
specified on the command line. Thus, one of the other cases in this table applies. 

IDENTIFICATION KEYWORDS 

Identifying information is inserted into the text retrieved from the SCCS file by replacing 
identification keywords with their value wherever they occur. The following keywords may be 
used in the text stored in an SCCS file: 


# 

t 

i 
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Keyword 


Km 

%Tt% 

%h% 

KB% 


%m 

%n% 

%T% 

%E% 


%G% 

%V% 

%Y% 


%p% 

%q% 

%c% 


%m 

%W96 


%K% 


Value 

Modale name: either the value of the m flag in the file (see admin{l)), or if absent, the 

name of the SCCS file with the leading s. removed. 

sees identification (SID) {%R%.%L%.%B%.%S%) of the retrieved text. 

Release. 

Level. 

Branch. 

Sequence. 

Current date (YY/MM/DD). 

Current date (MN^D/YY). 

Current time (HH:MM:SS). 

Date newest applied delta was created (YY/MM/DD). 

Date newest applied delta was created (MM/DD/YY). 

Time newest applied delta was created (I1H:MM:SS). 

Module type: v^ue of the t flag in the I^CS file (see «dmm(l)). 

SCCS file name. 

Fully qualified SCCS file name. 

The value of the q flag in the file (see a(fm»n(l)). 

Current line number. This keyword is intend^ for identifying messages output by the 
program such as ‘this shouldn’t have happened’ type errors. It is not intended to be 
used on every line to provide sequence numbers. 

The 4-character string 0(#) recognizable by wka<(l). 

A shorthand notation for constructing i(;Asf(l) strings for DNDC program files. %W% s 
%Z%%M%<horizontal-tab>%I% 

Another shorthand notation for constructing ii;Aat(l) strings for non-UNDC program flies. 

%A% - %Z%%Y% %M% %1%%Z% 


FILES 

Several auxiliary files may be created by get, These files are known generically as the g-file, l-JUe, 
p-file, and z-JUe. The letter before the hyphen is called the tag. An auxAiary file name is formed 
from the SCCS file name: the last component of all SCCS file names most be of the form 
»,module~name, the auxiliary files are named by replacing the leading a with the tag. The g-file is 
an exception to this scheme: the g-file is named by removing the n. prefix. For exmnple, ■jcjra.e, 
the auxUiary file names would be xysx, Lxysx, pand sjcya^, respectively. 

The g-file, which contains the generated text, is created in the current directory (unless the —p 
option is used). A g-file is created in all cases, whether or not any lines of text were generated by 
the get. It is owned by the real user. If the -k option is used or implied its mode is 644; other¬ 
wise its mode is 444. Only the real user need have write permission in the current directory. 

The l-file contains a table showing which deltas were applied in generating the retrieved text. 
The l-file is created in. the current directory if the —1 option is used; its mode is 444 and it is 
owned by the real user. Only the real user need have write permisdon in the current directory. 

Lines in the l-file have the following format: 


a. A blank character if the delta was applied; 

* otherwise. 

b. A blank character if the delta was applied or wasn’t applied and ignored; 

* if the delta wasn’t ^plied and wasn’t ignored. 

c. A code indicating a ‘special’ reason why the delta was or was not applied: 

‘I’: Included. 

‘X’: Excluded. 

‘C’: Cut off (by a -e option). 

d. Blank. 

e. sees identification (SID). 

f. Tab character. 
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g. Date and time (in the form YY/MM/DD HH:MM:SS) of creation. 

h. Blank. 

i. Login name of person who created delta. 


The comments and MR data follow on subsequent lines, indented one horizontal tab char¬ 
acter. A blank line terminates each entry. 

The p-file passes information resulting from a /usr/aecs/get -e along to delta. Its contents are 
also used to prevent a subsequent execution of a /uar/sees/get -« for the same SID until delta 
is executed or the joint edit flag, J, (see sdmtn(l)) is set in the SGGS file. The p~file is created in 
the directory containing the SGGS file and the effective user must have write permission in that 
directory. Its mode is 644 and it is owned by the effective user. The format of the p-file is: the 
gotten SID, followed by a blank, followed by the SDD that the new delta will have when it is made, 
fpllowed by a blank, followed by the login name of the real user, followed by a blank, followed by 
the date-time the get was executed, followed by a blank and the -I option if it was present, fol- 
li^wed by a blank and the —x option if it was present, followed by a new-line. There can be an 
ajfbitrary number of lines in the p-file at any time; no two lines can have the same new delta SID. 

‘^e z-JUe serves as a loek-out mechanism against simultaneous updates. Its contents are the 
bjpary (2 bytes) process ID of the command (that is, get) that created it. The z-file is created in 
the directory containing the SGGS file for the duration of get. The same protection restrictions as 
those for the p-file apply for the z-file. The z-file is created mode 444. 


SEE ALSO 

sccs(l), admin(l), delta(l), help(l), prs(l), what(l), sccsflle(5). 

Source Code Control Syotem in Programming Toolz for the Sun Workstation. 

DIAGNOSTICS 

Use help{l) for explanations. 

BUGS 

If the effective user has write permission (either explicitly or implicitly) in the directory contain¬ 
ing the SGGS files, but the real user doesn’t, only one file may be named when the —e option is 
used. 
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NAME 

gprof - display call graph profile data 
SYNOPSIS 

gprof I 1 I -b I I “« 11 -« »«»ne) (-B name ) ( -f nome) (-F name )[-•]( -a ] 

( a.out ( gmon.out ••• ] ] 

DESCRIPTION 

gprof produces an execution profile of C, Pascal, or Fortran?? programs. The effect of called rou¬ 
tines is incorporated in the profile of each caller. The profile data is tsJcen from the call graph 
profile file (gmon.out default) which is created by programs compiled with the —pg option of ee, 
te, and /77. That option also links in versions of the library routines which are compiled for 
)rofiling. The symbol table in the named object file {a.out default) is read and correlated with 
he call graph profile file. If more than one profile file is specified, the gprof output shows the sum 
^ the profile information in the given profile files. 

^irst, a flat profile is given, similar to that provided by prof{l). This listing gives the total execu¬ 
tion times and call counts for each of the functions in the program, sorted by decreasing time. 

i^ext, these times are propagated along the edges of the call gr^h. Cycles are discovered, and 
calls into a cycle are made to share the time of the cycle. A second listing shows the functions 
sorted according to the time they represent including the time of their call graph descendents. 
Below each function entry is shown its (direct) call graph children, and how their times are pro¬ 
pagated to this function. A similar display above the function shows how this function’s time and 
the time of its descendents is propagated to its (direct) call graph parents. 

Cycles are also shown, with an entry for the cycle as a whole and a listing of the members of the 
cycle and their contributions to the time and call counts of the cycle. 

OPTIONS 

-a suppresses thd printing of statically declared functions. If this option is given, all relevant 
information about the static function (for instance, time samples, calls to other functions, 
calls from other functions) belongs to the function loaded just before the static function 
in the a.out file. 

display a description of each field in the profile. 

the static call graph of the program is discovered by a heuristic which examines the text 
space of the object file. Static-only parents or children are indicated with call counts of 
0 . 

-« name 

suppresses the printing of the graph profile entry for routine name and all its descendants 
(unless they have other ancestors that aren’t suppressed). More than one -e option may 
be given. Only one name may be given with each -e option. 

-E name 

suppresses the printing of the graph profile entry for routine name (and its descendants) 
as -e, above, and ako excludes the time spent in name (and its descendants) from the 
total and percentage time computations. (For example, -E mcount -B mcleanup is the 
default.) 

-f name 

prints the graph profile entry of only the specified routine name and its descendants. 
More than one -f option mso'^ be given. Only one name may be given with each — f 
option. 

-F name 

prints the graph profile entry of only the routine name and its descendants (as -f, above) 
and also uses only the times of the printed routines in total time and percentage compu¬ 
tations. More than one -F option may be given. Only one name may be given with each 
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-F option* The -P option overrides the -E option. 

-8 a profile file gmon.eum is produced which represents the sum of the profile information in 
all the specified profile files. This summary profile file may be given to subsequent execu¬ 
tions of gprof (probably also with a -s) to accumulate profile data across several runs of 
an a.out file. 

-8 displays routines which have zero usage (as indicated by call counts and accumulated 
time). This is useful in conjunction with the -c option for discovering which routines 
were never called. 


FILES 


(^pton,oui 

gmon.Bum 


the namelist and text space, 
dynamic call graph and profile, 
summarized dynamic call graph and profile. 


SEE ALSjp 

imnitor(3), profil(2), cc(l), prof(l) 

Graham, S.L., Kessler, P.B., McKusick, M.K., 

'^gprof: A Call Graph Execution Profiler”, 

Proceedings of the SIGPLAN *82 Symposium on Compiler Construction, 
SIGPLAN Notices, Vol. 17, No. 6, pp. 120-126, June 1982. 


BUGS 

Beware of quantization errors. The granularity of the sampling is shown, but remains statistical 
at best. We assume that the time for each execution of a function can be expressed by the total 
time for the function divided by the number of times the function is called. Thus the time pro¬ 
pagated along the call graph arcs to parents of that function is directly proportional to the 
number of times that arc is traversed. 


Parents which are not themselves profiled will have the time of their profiled children propagated 
to them, but they will appear to be spontaneously invoked in the call graph listing, and will not 
have their time propagated further. Similarly, signal catchers, even though profiled, will appear 
to be spontaneous (although for more obscure reasons). Any profiled children of signal catchers 
should have their times propagated properly, unless the signal catcher was invoked during the 
execution of the profiling routine, in which case all is lost. 

The profiled program must call exit{2) or return normally for the profiling information to be saved 
in the gmon.out file. 
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NAME 

^raph - dra>i^ a ^aph 
SYNOPSIS 

l^raph ( spacing \ start ] j | -b J ( -c string ] [ --ig gridstyte] (-1 label j 
-m connectmpde J ( -a) | -x [ 1) lower ( upper [ spacing J | ] 

-y (11 lower ( upper ( spacing J ] J j -h fraction] (-w /racrton j [ --r fraction ] 

-u fraction] ( -t j ••• 

DESCRIfTION 

Graph with no optiona takes pairs of numbers from the standard input as abscissas and ordinates 
of a graph. Successive points are connected by straight lines. The graph is encoded on the stan¬ 
dard output for display by the plot{lG) filters. 

If the coordinates of a point are followed by a nonnumeric string, that string is printed as a label 
beginning on the point. Labels may be surrounded with quotes in which case they may be 
empty or contain blanks and numbers; labels never contain newlines. 

A legend indicating grid range is produced with a grid unless the -4 option is present. 

OPTIONS 

Each option is recognized as a separate argument. 

-a spacing [ start \ 

Supply abscissas automatically (they are missing from the input); spacing is the spacing 
(default 1). start is the starting point for automatic abscissas (default 0 or lower limit 
given by -x). 

-b Break (disconnect) the graph after each label in the input. 

-c string 

String is the default label for each point. 

—g gridstyle 

Gridstyle is the grid style: 0 no grid, 1 frame with ticks, 2 fuU grid (default). 

-1 label is label for graph. 

—m connectmode 

is mode (style) of connecting lines: 0 disconnected, 1 connected (default). Some devices 
give distinguishable line styles for other small integers. 

-s Save screen, don’t erase before plotting. 

-X [ I ] lower { upper [ spacing ] ] 

If I is present, z axis is logarithmic, lowernndupper are lower (and upper) z limits, spac- 
ing, if present, is grid spacing on z axis. Normally these quantities are determined 
automatically. 

-y 11J lower] upper [ spacing )) 

If 1 is present, y axis is logarithmic, lowernndupper are lower (and upper) y limits, spac- 
ing, if present, is grid spacing on y axis. Normally these quantities are determined 
automatically. 

“h fraction 

is fraction of space for height. 

—w fraction 

is fraction of space for width. 

-r fraction 

is fraction of space to move right before plotting. 

—u fraction 

is fraction of space to move up before plotting. 
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o 


-t Transpose horizontal and vertical axes. (Option -x now applies to the vertical axis.) 
If a specified lower limit exceeds the upper limit, the axis is reversed. 

SEE ALSO 

spline(lG), plot(lG) 

BUGS 

Graph stores all points internally and drops those for which there isn’t room. 

Segments that run out of bounds are dropped, not windowed. 

I^ogarithmic axes may not be reversed. 


o 
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NAME 

grep, egrep, fgrep - search a file for a pattern 
SYNOPSIS 

grep I -V ] (-c ] I -1 ] I -n ] I -b ) ( -1 ] I ->B ] I -w | [ expression ] expression ( file ]... 

egrep ( -v 1 ( -c J (-I ] ( -n | ( -b ) | -e j | -e ezpresston ) { -tfile \ ( expression ]( file ] ... 

fgrep ( -V 1 (-X 1 ( -e 1 (-11 (-n 11 -b 1 (-111 -a) { tzprtasion | [ --tfile j 

[ strings ] [ file ] ••• 

DESCRIPTION 

Pommands of the grtp family search the input (standard input default) for lines matching a 
pattern. Normally, each line found is copied to the standard output. Grep patterns are limited 
regular expressions in the style of ex(l). Egrep patterns are full regular expressions including 
alternation. Fgrep searches for lines that contain one of the (newline-separated) strings. Fgrep 
patterns are fixed strings — no regular expression metacharacters are supported. 

In general, egrep is the fastest of these programs. 

Take care when using the characters $ * [ " | ( ) 2 tnd \ in the expression as these characters are 
also meaningful to the Shell. Enclose the entire expression argument in single quotes ' ' if you 
need any of the above special characters in the expression. 

When any of the grep utilities is applied to more than one input file, the name of the file is 
displayed preceding each line which matches the pattern. The filename is not displayed when 
processing a single file, so if you actually want the filename to appear, use jdevjnuU as a second 
file in the list. 

OPTIONS 

-V Invert the search to only display lines that do not match. 

-X Display only those lines which match exactly — that is, only lines which match in their 

entirety (fgrep only). 

Display a count of matching lines. 

-1 Lbt the names of files with matching lines (once) separated by newlines. 

-n Precede each line by its relative line number in the file. 

—b Precede each line by the block number on which it was found. This b sometimes useful 

in locating dbk block numbers by context. 

—1 Ignore the case of letters in making comparbons — that b, upper and lower case are con¬ 
sidered identical. Thb applies to grep and fgrep only. 

-a Work silently, that b, dbplay nothing except error messages. This is useful for checking 
the error status. 

-w search for the expression as a word as if surrounded by ‘\<’ and sec cx(l). grep 
only. 

—e expression 

Same as a simple expression argument, but useful when the expression begins with a 
--t file Take the regular expression (egrep) or string lbt (fgrep) from file. 

REGULAR EXPRESSIONS 

In the following description ‘character* excludes newline: 

\ Is an escape character: \ followed by any single character other than newline matches 
that character. 

Anchored match: matches the beginning of a line. 

$ Anchored match: matches the end of a line. 
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• (period) matches any character. 

d Where c is any single character not otherwise endowed with ^cial meaning matches that 
character. 

I string] 

Character class: match any single character from string. Ranges of ASCII character codes 
may be abbreviated as in *ar-z0-9’. A ] may occur only as the first character of the string. 
A literal - must be placed where it can*t be mistaken as a range indicator. A 
(circumflex) character immediately after the open bracket negates the sense of the charac* 
ter class, that is, the pattern matches any character except those in the character class. 

^ Closure: a regular expression followed by an (asterisk) matches a sequence of 0 or more 
matches of the regular expression. 

+ Closure: a regular expression followed by a + (plus) matches a sequence of 1 or more 
matches of the regular expression. 

f Closure: a regular expression followed by a ? (question mark) matches a sequence of 0 or 1 
matches of the regular expression. 

cqncatenation 

Two regular expressions concatenated match a match of the first followed by a match of 
the second. 

I Alternation: two regular expressions separated by | or newline match either a match for 
the first or a match for the second {egrep only). 

0 A regular expression enclosed in parentheses matches a match for the regular expression. 

The order of precedence of operators at the same parenthesis level is [ ] (character classes), then 
^ + t (closures), then concatenation, then | (alternation) and newline. 

EXAMPLES 

Search a file for a fixed string using fgrep: 

% fgrep Intro /uBr/m8ai/man3/*.3* 

Look for character classes using grep: 

% grep ’[1-8]([CJMSNX])* /u8r/man/manl/*«l 
Lqok for alternative patterns using egrep: 

% egrep *(SaUy|Fred) (SmIth|Jone8|Parker)* teIephone.ll8t 

T(| get the filename displayed when only processing a single file, use f devj null as the second file in 
tki list: 

\i % grep *SaUy Parker* telephone.ll8t /dev/null 

SEE ALSO 

ex(l), 8ed(l), sh(l) 

DIAGNOSTICiS 

Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or inaccessible files. 

BUGS 

Lines are limited to 256 characters; longer lines are truncated. 

Ideally there should be only one grep, but for historical reasons there are three different versions 
each with a slightly different set of options and syntaxes. 
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NAME 

groups - show group memberships 

SYNOPSIS 

j^roupa 

DESCRIPllON 

groups displays the groups to which you belong. Each user belongs to a group specified in the 
password file letelpasswd and possibly to other groups as specified in the file fetcf group. If you do 
pot own a file but belong to the group which it is owned by then you are granted group access to 
^e file. 

When a new file is created it is given the group of the containing directory. 

SEE ALSO 

setgtoups(2) 

FILES 

/etc/passwd, /etc/group 
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NAME 

head - display first few liaes of specified files 
SYNOPSIS 

head I -count] [ file ... ] 

DESCRIPTION 

Head copies the first count lines of the specified file(s), or of the standard input if no filename is 
given, to the standard output. The default value of couni is 10 lines. 

When more than one file is specified, head places a marker at the start of each file which looks 
e: 

==B> filename <== 

lus, a common way to display a set of short files, identifying each one, is: 
gaia% head -OOOO fllel file! ... 

EXAMPLE 

gaia% head -4 /usr/maii/manl/{cat,head,tall}.l 
■*=»> /usr/mao/manl/cat.l <a»a» 

.TH CAT 1 ”2 June 1983" 

.SH NAME 

cat - concatenate and display 
.SH SYNOPSIS 

a=s=> /usr/man/manl/head.i <*»*» 

.TH HEAD 1 "24 August 1983" 

.SHNAME 

head - display first few lines of specified files 
.SH SYNOPSIS 

==> /usr/man/manl/taU.l <==» 

.TH TAIL 1 ”27 AprU 1983” 

.SHNAME ^ 

tail - display the last part of a file 
.SH SYNOPSIS 

SEE ALSO 

more(l), tail(l), cat(l) 
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NAME 

help - ask for help 

SYNOPSIS 

/uar/aces/help [args] 

DESCRH»TION 

Help finds information to explain a message from a command or explain the use of a command. 
Zero or mote arguments may be supplied. If no arguments are given, kelp will prompt for one. 

The arguments may be either message numbers (which normally appear in parentheses following 
messages) or command names, of one of the following types; 

type 1 Begins with non>nomerics, ends in numerics. The non>numeric prefix is 
'' usually an abbreviation for the program or set of routines which produced 

the message (for example, ge6, for message 6 from the pet command). 

type 2 Does not contain numerics (as a command, such as get) 
type 3 Is all numeric (for example, 212) 

The response of the program will be the explanatory information related to the argument, if there 
is any. 

When all else fails, try /uar/aces/help stuck. 

FILES 

/usr/lib/help directory containing files of message text. 

DIAGNOSTICS 

Use kelp{l) for explanations. 
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NAME 

hoetid - print identifier of current host qrstem 

SYNOPSIS 

hontld 

DESCRIPTION 

The hoetid command prints the identifier of the current host in hex. This numeric value is unique 
across all hosts. 

SEE ALSO 

^etho8tid(2) 
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NAME 

hoetname - set or print name of current host system 
SYNOPSIS 

hostname (nameofhost ] 

DESCRIPTION 

The hottnamt command prints the name of the current host, as ghren before the “login” prompt. 
The super-user can set the hostname by giving an argument; this is usualty done in the startup 
script /etc/rc.loea]. 

SEE A^^SO 

gethostname(2), 8ethostname(2) 
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NAME 

indent - indent and format C program source 
SYNOPSIS 

Indent input [ output j {flags ] 

DESCRIPTION 

Indent is intended primarily as a C program formatter. Specifically, indent will: 

• indent code lines 

• align comments 

• insert spaces around operators where necessary 

s bresJc up declaration lists as in ‘*int a,b,c;”. 

Indent will not break up long statements to make them fit within the maximum line length, but it 
will flag lines that are too long. Lines will be broken so that each statement starts a new line, 
and braces will appear alone on a line. (See the -br option to inhibit this.) Also, an attempt is 
made to line up identifiers in declarations. 

The flags which can be specified follow. They may appear before or after the file names. If the 
output file is omitted, the formatted file will be written back into input and a “backup” copy of 
input will be written in the current directory. If input is named “/blah/blah/file”, the backup file 
will be named “.Bfile”. If output is specified, indent checks to make sure it is different from input. 

The following flags may be used to control the formatting style imposed by indent. 

-Innn Maximum length of an output line. The default is 75. 

-ennn The column in which comments will start. The default is 33. 

-ednnn The column in which comments on declarations will start. The default is for these 
comments to start in the same column as other comments. 

The number of spaces for one indentation level. The default is 4. 

-dj will cause declarations to be left justified, -ndj will cause them to be indented the 
same as code. The default is -ndJ- 

-V turns on “verbose” mode, -nv turns it off. When in verbose mode, indent will 
report when it splits one line of input into two or more lines of output, and it will give 
some size statistics at completion. The default is -nv. 

If -be is specified, then a newline will be forced after each comma in a declaration, 
-nbe will turn off this option. The default is -be. 

This option controls the placement of comments which are not to the right of code. 
Specifying -d2 means that such comments will be placed two indentation levels to the 
left of code. The default -dO lines up these comments with the code. See the section 
on comment indentation below. 

Specifying -bl will cause complex statements to be lined up like this: 
if(...) 

{ 

code 

} 

Specifying -br (the default) will make them look like this: 
if (...){ 
code' 

} 


-Innn 

-dj,-ndj 

-v,-nv 

-bc,-nbc 

-dnnn 


-br,-bl 
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You in$y set up your own “profile” of defaults to indent by creating the file “.indent.pro” in your 
login directory and including Whatever switches you like. If indent is run and a profile file exists, 
then it is read to set up the program’s defaults. Switches on the command line, though, will 
always override profile switches. The profile file must be a single line of not more than 127 char¬ 
acters. The switches should be separated on the line by spaces or tabs. 

Multi-line exprcMlone 

Indent y/lll not break up complicated expressions that extend over multiple lines, but it will usu¬ 
ally correctly indent such expressions which have already been broken up. Such an expression 
might end up looking like this: 

X =» 

( 

(Arbitrary parenthesized expression) 

+ 

( 

(Parenthesized expression) 

* 

(Parenthesized expression) 

) 

); 

Commentf 

Indent recognizes four kinds of comments. They are: straight text, ‘‘box’’ comments, UNDC-style 
comments, and comments that should be passed through unchanged. The action taken with these 
various types are as follows: 

“Boj” eomment$e Indent assumes that any comment with a dash immediately after the start of 
comment (i.e. **/*-”) is a comment surrounded by a box of stars. Each line of such a comment 
will be left unchanged, except that the first non-blank character of each successive line will be 
lined up with the beginning slash of the first line. Box comments will be indented (see below). 

^Vnix-style^* eommente. This is the type of section header which is used extensively in the UNIX 
system source. If the start of comment (“/*”) appears on a line by itself, indent assumes that it 
is a UNEX-style comi^ent. These will be treated similarly to box comments, except the first non¬ 
blank character on each line will be lined up with the ‘*’ of the 

Unchanged comments. Any comment which starts in column 1 will be left completely unchanged. 
This is intended primarily for documentation header pages. The check for unchanged comments 
is made before the check for UNiX-style comments. 

Straight text. All other comments are treated as straight text. Indent will fit as many words 
(separated by blanks, tabs, or newlines) on a line as possible. Straight text comments will be 
indented. 

Comment indentation 

Box, UNEX-style, and straight text comments may be indented. If a comment is on a line with 
code it will be started in the “comment column”, which is set by the —cnnn command line 
parameter. Otherwise, the comment will be started at nnn indentation levels less than where 
code is currently being placed, where nnn is specified by the -^nnn command line parameter. 
(Indented comments will never be placed in column 1.) If the code on a line extends past the com¬ 
ment column, the comment will be moved to the next line. 

DIAGNOSTICS 

Diagnostic error messages, mostly to tell that a text line has been broken or is too long for the 
output line. 
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FILES 

.indent.pro profile file 

BUGS 

Does not know how to format "long” declarations. 
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NAME 

indxbib - make inverted index to a bibliography 
lookbib - find references in a bibliography 

SYNOPSIS 

Indxbib database ... 
lookbib database 

DESCMPTION 

Indxbib makes an inverted index to the named databases (or files) for nse by lookbib{l) and 
re/er(l), These files contain bibliographic references (or other kinds of information) separated by 
blank Unes. 

A bibliographic reference is a set of lines, constituting fields of bibliographic information. Each 
field starts on a line beginning with a followed by a key-letter, then a blmik, and finally the 
contents of the field, which may continue until the next line starting with 

Indxbib is a shell script that calls /usr/lib/refer/mkey and /usr/lib/refer/inv. The first program, 
mkeji, truncates words to 6 characters, and maps upper case to lower case. It also discards words 
shorter than 3 characters, words among the 100 most common English words, and numbers 
(dates) < 1900 or > 2000. These parameters can be changed; see page 4 of the Refer document 
by Mike Lesk. The second program, inv, creates an entry file (.ia), a posting file (.ib), and a tag 
file (.ic), all in the working directory. 

Lookbib uses an inverted index made by indxbib to find sets of bibliographic references. It reads 
keywords typed ^ter the “>” prompt on the terminal, and retrieves records containing all these 
keywords. If nothing matches, nothing is returned except another “>” prompt. 

It is possible to search multiple databases, as long as they have a common index made by indxbib. 
In that case, only the first argument given to indxbib is specified to lookbib. 

If lookbib does not find the index files (the .i[abc| files), it looks for a reference file with the same 
name as the arguiilent, without the suffixes. It creates a file with a ’.ig’ suffix, suitable for use 
with fgrep. It then uses this fgrep file to find references. This method u simpler to use, but the .ig 
file is slower to use than the .i[abc] files, and does not allow the use of multiple reference files. 

FILES 

e.ia, x.ib, a.ic, where x is the AM argument, or if these are not present, then a.ig, x 
SEE ALSO 

refer(l), addbib(l|i tiortbib(l), roffbib(l), lookbib(l) 

BUGS 

Probably all dates sboul<t be indexed, since many disciplines refer to literature written in the 
1800s or earlier. 
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NAME 

inews - submit uews articles 
SYNOPSIS 

inewi ( -h ) -t iitU | -n newsgroups ] (expiration date ) 
inews -p (filename ] 
inews —C newsgroup 
DESCRIPTION 

Inews submits news articles to the USENET news network. Inews is intended as a raw interface to 
tke news ^stem, not as a human user interface. Casual users should probably use postnews{l) 
instead. 

The first form of inews is for submitting user articles. The body of the article is read from the 
standard input. A title must be specified as there is no default. Each article belongs to a list of 
newsgroups. The standard list of newsgroups is used if the list is not specified via the -n option. 
On the Sun ^stem, the standard subscription list is: general, alLgeneral, general, alLannounce, 
tjunk, Icontrol, and Itest, If you wish to submit an article in multiple newsgroups, the newsgroups 
must be separated by commas and/or spaces. The expiration date is set to the local default if not 
otherwise specified. 

When posting ail article, the environment is checked for information about the sender. If NAME 
is found, its value is used for the full name, rather than the system value obtained from 
/etefpasswd. This is useful if the system value cannot be set, or when more than one person uses 
the same login. If ORGANIZATION is found, the value overrides the ^stem default organization. 
This is useful when a person uses a guest login and is not primarily associated with the organiza¬ 
tion owning the machine, tt 

The second form of ih^ews is for receiving articles froin other machines. If filename is given, the 
article is read from, tlie Specified file; otherwise the article is read from the standard input. An 
expiration date need not be present and a receival date is ignored if present. 

After local installation, mews transmits the article to all systems that subscribe to the newsgroups 
that the article Uletongs to. 

The third form iif meu;e is fof creating new newsgroups. On some systems, this may be limited to 
specific users such as the super-user or news administrator. This is true on the Sun system. 

If the file !usrjlibl)/iewslrecording is present, it is taken as a list of ^recordings' to be shown to 
users posting news. This is an analogy to the recording you hear when you dial information in 
some parts of tke country, asking you if you really wanted to do this, jusr!lihjnewsf recording 
contains lines of the form: 

newsgroups <tab> filename 
forexamplb^. 

net.all net*rCcording fa.all fa.recording 

Any user postib| an article to a newsgroup matching the pattern on the left is shown the contents 
of the file on the right. The file is found in the LEB directory (often j usr j lib f news). The user is 
then told to hit DEL to abort or RETURN to proceed. The intent of this feature is to help com¬ 
panies keep proprietary information from accidently leaking out. 

OPTIONS 

-n * newsgroups'* . " 

specifies a list of newsgroups to which the articles are submitted. Elements in the list 
must be separated by commas and/or spaces. The expiration date is set to the local 
default if not otherwise specified. 

-f I sender) 

Specifies the article’s sender. Without this flag, the sender defaults to the user’s name. If 
-f is specified, the real sender’s name is included as a Sender line. 
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-h Headers are present at the beginning of the article, and these headers should be included 
with the article header instead of as text. Thb mechanism can be used to edit headers 
and supply additional nondefault headers, but not to specify certain information, such as 
the sender and article ID that inews itself generates. 


FILES 


/usr/spool/news/.qrs.nnn temporary articles 
fim/tpool/iieynfneu>»group»/artiele_n 0 . 

Articles 


/usr/spool/oldnews/ 

/usr/lib/news/active 

/usr/lib/news/seq 

/usr/lib/news/history 

/usr/lib/news/sys 

SEE ALSO 


Expired articles 

List of known newsgroups and highest local article numbers in each. 
Sequence number of last article 
List of all articles ever seen 
System subscription list 


mail(l), binmail(l), getdate(3), news(5), newsrc(S), poBtnew8(l), readnews(l), recnews(l), send- 
news(8), uucp(l), uurec(8). 

Network News Uoer’o Guide in the Beginner's Guide to the Sun Workstation. 
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o NAME 

install - install files 
SYNOPSIS 

tnataU ( -e ] ( —m mode ] | -o owner ] ( -g group ] ( -■ ] binary destination 
DESCRIPTION 

Binary is copied to destination. If destination already exists, it is removed before binary is copied. 
If the destination is a directory then binary is copied into file destination!binary. 

Install refuses to move a file onto itself. 

Note: install has no special privileges since it simply uses cp to copy files from one place to 
another. The implications of this are: 

• You must have permission to read binary. 

• You must have permission to copy into destination. 

• You must have permission to change the modes on the final copy of the file if you want to use 
the -m option to change modes. In addition, if you want to set any modes (such as set-user¬ 
id), )[ou must be super-user. 

• You must be super-user if you want to use the -o option to change ownership. 

OPTIONS 

-e popy binary instead of moving it. In fact, instaU always copies the file, but the -e option 
IS. retained for backwards compatibility with old system shell scripts which might other- 
Virise break. 

-m modi 

Specifies a different mode for binary: the mode for destination is set to 755 by default. 

-o owner 

Set the owner of the destination file to owner, destination is changed to owner root by 
default. 

-g group 

Set the group ownership of the destination file to group, destination is changed to group 
Staff by default. 

-a Strip binary files after it is installec) — only applicable to binary files in a.out(5) format. 
SEE ALSO 

cbmod(l), cp(l), mv(l), strip(l), chown(8) 

BUGS 

Should be possible to move multiple files at a time, like mv(l) or cp(l). 

When the destination is a directory, install simply appends the entire source file name to the 
directory name, instead of using the source file name’s last component like mv(l) or cp(l). 
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NAME 

join - relational database operator 
SYNOPSIS 

Join ( -an ) ( -estring j [ -jn.m | | -o list ] | -tc) file! file2 
DESCRIPTION 

Join forms, on the standard output, a join of the two relations specified by the lines of filel and 
file£. If filel is , the standard input is used. 

Filel and fileS must be sorted in increasing ASCII collating sequence on the fields on which they 
are to be joined, normally the first in each line. 

There is one line in the output for each pair of lines in file! and file2 that have identical join 
fields. The output line normally consists of the common field, then the rest of the line from filel, 
then the rest of the line from file2. 

Fields are separated by blanks, tabs or newlines. Multiple separators count as one, and leading 
separators are discarded. 

OPTIONS 

-an The parameter n can be one of the values: 

1 produce a line for each unpairable line in filel. 

2 produce a line for each unpairable line in file2. 

3 produce a line for each unpairable line in both filel and JUe2. 

The normal output is also produced. 

-e 9 Replace empty output fields by eiring. 

—Jn«m Join on the mth field of file n. If n is missing, use the mth field in each file. 

-o liet Each output line comprises the fields specifed in lUt, each element of which has the form 
n.m, where n is a file number and m is a field number. 

-tc Use ckaracter c as a separator (tab character). Every appearance of c in a line is 
significant. 

SEE ALSO 

8ort(l), comm(l), awk(l), uniq(l), look(l) 

BUGS 

With default field separation, the collating sequence is that of sort -b; with -t, the sequence is 
that of a i)lain sort. 

The conventions of iom(l), s(^r/(l), comm(l), tint 9 (l), look{l), and au;Jb(l) are wildly incongruous. 
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NAME 

kill - send a signal to a process, or terminate a process 
SYNOPSIS 

kill (-sig ) processid ... 
kUl -1 

DESCRIPTION 

Kill sends the TERM (terminate, 15) signal to the specified processes. If a signal name or number 
preceded by is given as first argument, that signal is sent instead of terminate (see aigvec{2)). 
The signal names are listed by using the -1 option, and are as given in fuerfincludefsignal.h, 
stripped of the common SIG prefix. 

The terminate signal will kill processes that do not catch the signal, so kill —0 ... is a sure kill, 
as the KILL (9) signal cannot be caught. By convention, if process number 0 is specified, all 
members in the process group (that is, processes resulting from the current login) are signaled (but 
beware: this works only if you use 95(1); not if you use C95(l).) The killed processes must belong 
to the current user unless he is the super>user. 

To shut the system down and bring it up single user the super-user may send the initialization 
process a TERM (terminate) signal by ‘kill 1’; see tntl(8). To force init to close and open termi¬ 
nals according to what is currently in /etc/ttys use ‘kill -HUP 1’ (sending a hangup, signal 1). 

The shell reports the process number of an a^nchronous process started with (run in the 
background). Process numbers can also be found by using p9(l). 

Kill is built in to C95(l); it allows job specifiers, such as kill %..., in place of kill arguments. 
See 095(1) for details. '' 

OPTIONS 

-1 Display a list of signal names. 

SEE ALSO 

C8b(l), p8(l), kill(2), sigvec(2) 

BUGS 

An option to kill process groups ala killpg(2) should be provided; a replacement for kill 0 for 
c95(1) users should be provided. 
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NAME 

last - indicate last logins of users and teletypes 
SYNOPSIS 

last ( -number ]( -t filename ] ( name ... ] (tty ... ] 

DESCRIPTION 

Laat looks back in the wtmp file which records all logins and logouts for information about a user, 
a teletype or any group of users and teletypes. Arguments specify names of users or teletypes of 
interest. Names of teletypes may be given fully or abbreviated. For example ‘last 0’ is the same 
as 'last ttyO’. If multiple arguments are given, the information which ^plies to any of the argu¬ 
ments is printed. For example ‘last root console’ would list all of "root’s” sessions as well as all 
sessions on the console terminal. La»t displays the sessions of the specified users and teletypes, 
most recent first, indicating the times at which the session began, the duration of the session, and 
the teletype which the session took place on. If the session is still continuing or was cut short by 
a reboot, laat so indicates. 

The pseudo-user reboot logs in at reboots of the system, thus 
last reboot 

will give an indication of mean time between reboot. 

Laat with no arguments displays a record of all logins and logouts, in reverse order. 

If laat is interrupted, it indicates how far the search has progressed in wtmp. If interrupted with a 
quit signal (generated by a controI-\) laat indicates how far the search has progressed so far, and 
the search continues. 

OPTIONS 

-number 

limit the number of entries displayed to that specified by number. 

—t filename 

Use filename as the name of the accounting file instead of /etcfwtmp. 

FILES 

/usr/adm/wtmp login data base 

/usr/adm/shutdownlog which records shutdowns and reasons for same 
SEEALSO 

utmp(5), ac^s), Ih^tcomm(l) 
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NAME 

lastcomm - show last commands executed in reverse order 
SYNOPSIS 

lastcomm [ command name ] ... [user name] ... [terminal name] ... 

DESCRIPTION 

Lastcomm gives information on previously executed commands. Lastcomm with no arguments 
displays information about all the commands recorded during the current accounting file’s life¬ 
time. If called with arguments, lastcomm only displays accounting entries with a matching com¬ 
mand name, user name, or terminal name. 

EXAMPLES 

tutorial^ lastcomm a.out root ttydO 

would produce a listing of all the executions of commands named a.out, by user root while using 
the terminal ttydO. and 

tutorisl% lastcomm root 

would produce a listing of all the commands executed by user root. 

For each process entry, lastcomm displays the following items of information: 

• The command name under which the process was called. 

e One or more flags indicating special information about the process. The flags have the follow¬ 
ing meanings: 

F The process performed a fork but not an exec. 

S The process ran as a set-user-id program. 

D The process dumped memory. 

X The process was killed by some signal. 

• The name of the user who ran the process. 

• The terminal which the user was logged in on at the time (if applicable). 

• The amount of CPU time used by the process (in seconds). 

• The date and time the process exited. 

FILES 

/usr/adm/acct accounting flle 

SEE ALSO 

last(l). The name of the user who ran the process. 

Flags, as accumulated by the accounting facilities in the system. 

The command name under which the process was called. 

The amount of cpu time used by the process (in seconds). 

The time the process exited. sigvec(2), acct(5), core(5) 
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NAME 

Id - link editor 
SYNOPSIS 

Id ( -A name ] | -D Acx) ( --d | ( -e entry ) | -11 1 -M ] [ -N ] ( -n ) [ -o name 1 ( ) | -S J 

( -a ] I -T Acx J ( -t) [ -u name ] (-X ] ( -x ] [ -ysymbol ] [ -a ] file ... 

DESCRIPTION 

Ld combines several object programs into one, resolves external references, and searches libraries. 
In the simplest case several object files are given, and Id combines them, producing an object 
module which can be either executed or become the input for a further Id run. In the latter case, 
the -r option must be given to preserve the relocation bits. The output of Id is left on a file called 
a.out if not otherwise specified. The output file is made executable only if no errors occurred dur¬ 
ing the load. 

The argument files are concatenated in the order specified. The entry point of the output is the 
beginning of the first routine unless the -e option is specified. 

If any file is a library, it is searched exactly once at the point it is encountered in the argument 
list. Only those routines defining an unresolved external reference are loaded. If a routine from a 
library references another routine in the library, and the library has not been processed by ran- 
lib{i), the referenced routine must appear after the referencing routine in the library. Thus the 
order of programs within libraries may be important. The first member of a library should be a 

file named *_.SYMDEF*, which is understood to be a dictionary for the library as produced by 

ran/i6(l); the dictionary is searched iteratively to satisfy as many references as possible. 

The symbols _etext, _edatm and _end (etext, edata and end in C) are reserved, and if referred 
to, are set to the first location above the program, the first location above initialized data, and 
the first location above all data respectively. It is erroneous to define these symbols. 

OPTIONS 

Options should ap{>ear before the file names, except abbreviated libraiy names specified by the -1 
option which cah appear anywhere. 

-A name 

Incremental loading: linking is to be done in a manner so that the resulting object may be 
read into an already executing program. The next argument is the name of a file whose 
symbol table is taken as a basis on which to define additional symbols. Only newly 
linked material is entered into the text and data portions of a«out, but the new ^mbol 
table will reflect every symbol defined before and after the incremental load. This argu¬ 
ment must appear before any other object file in the argument list. The -T option may 
be used as well, and will be taken to mean that the newly linked segment will commence 
at the corresponding address (which must be a multiple of the pagesize). The default 
value is the old valh^ iif .end. 

-D hex Pad the segmcfilt with zero bytes until the data segment is hex bytes long. 

-e entry 

Define the entry point: entry argument is the name of the entry point of the loaded pro¬ 
gram. 

This option is an abbreviation for the library name ‘/lib/libar.a’, where 2 is a string. If 
that does not exist. Id tries ‘/usr/lib/libaj.a* A library is searched when its name is 
encountered, so the placement of a -1 is significant. 

Produce a primitive load map, listing the names of the files which will be loaded. 

Do not make the text portion read only or sharable. (Use ^magic number’ 0407.) 

Arrange (by giving the output file a 0410 *magic number’) that when the output file is 
executed, the text portion will be read-only and shared among all users executing the file. 
This involves moving the data areas up to the first possible segment boundary following 
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the end of the text, 
name 

Name is the neme of the Id output file, instead of a.out. 

Generate relocation bits in the output file so that it can be the subject of another Id run. 
This flag also prevents final definitions from being given to common symbols, and 
suppresses the ^undefined symbol’ diagnostics. 

Force definition of common storage even if the -r flag is present. 

-S Strip the output by removing all symbols except locals and globals. 

--8 Strip the output, that is, remove the symbol table and relocation bits to save space (but 
impair the usefulness of the debuggers). This information can also be removed by 

-T hex Start the text segment origin at location hex. 

Trace: display the name of each file as it is processed. 

—u name 

Enter name as an undefined symbol. This is useful for loading ivholly from a library, 
since initially the symbol table is empty and an unresolved reference is needed to force 
the loading of the first routine. 

Save local symbols except for those whose names begin with This option is used by 
cc(l) to discard internally-generated labels while retaining symbols local to routines. 

-X Do not preserve local (non- .globl) symbols in the output symbol table; only enter exter¬ 
nal symbols. This option saves some space in the output file. 

^yeym Display each file in which eymbot appears, its type and whether the file defines or refer¬ 
ences it. Many such options may be given to trace many symbols. It is usually necessary 
to begin symbol with an as external C, FORTRAN and Pascal variables begin with 
underscores. 

—8 Arrange for the process to be loaded on demand from the resulting executable file (0413 
'magic number’) rather than preloaded. This is the default. Results in a page-sized 
header on the output file followed by a text and data segment each of which have size a 
multiple of page-size bytes (being padded out with nuUs in the file if necessary). With 
this format the first few BSS segment symbols may actually end up in the data segment; 
this is to avoid wasting the space resulting from data segment size roundup. 

FILES 

/lib/lib’^.a libraries 

/usr/lib/lib’^.a more libraries 

/u8r/locaI/lib/lib*.a still more libraries 
a.out output file 

SEE ALSO 

as(l), ar(l), cc(l), ranlib(l), strip(l) 

BUGS 

There is no way to force data to be page aligned. 
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NAME 

leave - remind you when you have to leave 

SYNOPSIS 

leave [(+]hhmm ] 

DESCRIPTION 

Leave sets an alarm to a time you specify and will tell you when the time is up. Leave waits until 
the specified time, then reminds you that you have to leave. You are reminded 5 minutes and 1 
minute before the actual time, at the time, and every minute thereafter. Leave disappears after 
you log off. 

You can specify the time in on of two ways, namely as an absolute time of ds^ in the form hhmm 
where M is a time in hours (on a 12 or 24 hour clock), or you can place a -f* sign in front of the 
time, in which case the time is relative to the current time, that is, the specified number of hours 
and minutes from now. All times are converted to a 12 hour clock, and assumed to be in the next 
12 hours. 

If no argument is given, leave prompts with "When do you have to leave?”. Leave exits if you 
just type a newline, otherwise the reply >• assumed to be a time. This form is suitable for inclu¬ 
sion in & .login or ^profile. 

Leave ignores interrupts, quits, and terminates. To get rid of it you should either log off or use 
kill -0 and its process id. 

SEE ALSO 

calendar(l) 

EXAMPLES 

The first example sets the alarm to an absolute time of day: 
tutorial^ leava 1536 
Alarm set for Wed Mar 7 15:35:07 1984 

work work work work 

tutorial^ Time to leave! 

The second example sets the alarm for 10 minutes in the future: 
tutorial^ leava -(-10 
Alarm set for Wed Mar 7 15:45:24 1984 

. work work work work 

tutorial% Time to leave! 

work work work work 

tutorial% You’re going to be late! 
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NAME 

lex - generator of lexical analysis programs 

SYNOPSIS 

lex ( -tvfh ]{ file ] .«« 

DESCRIPTION 

Lex generates programs to be used in simple lexical analyis of text. The input files (standard 
input default) contain regular expressions to be searched for, and actions written in C to be exe¬ 
cuted when expressions are found. 

A C source program, ’lex.yy.c’ is generated, to be compiled thus: 
cc lex.yy.c -11 

This program, when run, copies unrecognized portions of the input to the output, and executes 
the associated C action for each regular expression that is recognized. 

OPTIONS 

-t 

-V 

-n 
-f 

EXAMPLE 
would 


is an example of lex. This program converts upper case to lower, removes blanks at the end of 
lines, and replaces multiple blanks by single blanks. 

SEE ALSO 

yacc(l), 8ed(l) 

The paper, LEX - A Lexical Analyzer Generator, in the Sun Programming Tools Manual. 


Place the result on the standard output instead of in file lex.yy.e. 

Print a one-line summary of statistics of the generated analyzer. 

Opposite of -v; ~n is default. 

'Faster* compilation: don’t bother to pack the resulting tables; limited to small programs, 
lex lexcommands 

draw lex instructions from the file lexcommands, and place the output in lex.yy.e 
%% 

[A-Z] putchar(yyt6jtl[0)-H 'a-'A*); 

ll+t 

()+ putchar( *'); 
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NAME 

liat - a C program verifier 
SYNOPSIS 

Unt I -abchnuvx ] {—D name=ic/) (-D name) ( —Unamc J (-Idir] file ... 

Unt [ -C/»i ] file ... 

DESCRIPTION 

Ltn( attempts to detect features of the C program Jllee which are likely to be bugs^ or non¬ 
portable, or wasteful. It also checks the type usage of the program more strictly than the com¬ 
pilers. 

Among the things which are currently found are unreachable statements, loops not entered at the 
top, automatic variables declared and not used, and logical expressions whose value is constant. 
Moreover, the usage of functions is. checked to find functions which return values in some places 
and not in others, functions called with varying numbers of arguments, and functions whose 
values are not used. 

By default, it is assumed that all the are to be loaded together; they are checked for mutual 
compatibility. Function definitions for certain libraries are avaOable to lint; these libraries are 
referred to by a conventional name, such as -Im, in the style of The standard C library 

(-le) is lint'tA by default. Arguments ending in .In are also treated as library files. 

To create lint libraries^ use the -C option: 
lint -Ccongress files... 

where ^cs are the C sources of library congrett. The result is a Sle Uib-lcongrettJn in the correct 
library format suitable for linting programs using -leongrcM. 

OPTIONS I,. 

h Apply a number of heuristic tests to attempt to intuit bugs, improve style, and reduce 
waste. 

b Report break statements that cannot be reached. This is not the default because, unfor^ 
tunately, most lex and many pace outputs produce dozens of such comments. 

y Suppress complaints about unused arguments in functions. 

X Report variables referred to by extern declarations, but never used, 
a Report assignments of long values to Int variables, 
e Complain about casts which have questionable portability. 

u Do not complain akout functions and variables used and not defined, or defined and not 
used (this is suitable for running /ml on a subset of files out of a larger program). 

n Do not check compatibility against the standard library. 

a Do not complain about structures that are never defined (e.g. using a structure pointer 

without knowing its contents.). 

—Dneme*^def 

-Dname 

Define name to the preprocessor, as if by ‘#define’. If no definition is given, the name is 
defined as ”1”. 

-Utiame 

Remove any initial definition of name. 

-Idir ‘#include’ files whose names do not begin with '/’ always sought first in the directory 
of the file argument, then in directories named in -I options, then in the fuarlinelude 
directory. 

-Clib create a Unt library with name tib (see DESCRIPTION section). 
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-U»6 use lint library lib from the juarj lib flint directory. 

General Commenta 

The routine exit{2) and other functions which do not return are not understood; this causes vari¬ 
ous lies. 

Certain conventional comments in the 0 source will change the behavior of lint: 
/*NOTREACHED*/ 

at appropriate points stops comments about unreachable code. 

/♦VARARGSn*/ 

suppresses the usual checking for variable numbers of arguments in the following function 
declaration. The data types of the first n arguments are checked; a missing n is taken to 
beO. 

/*NOSTRICT*/ 

shuts off strict type checking in the next expression. 

/♦ARGSUSED*/ 

turns on the -v option for the next function. 

/•LINTLIBRARY*/ 

at the beginning of a file shuts off complaints about unused functions in this file. 

EXAMPLE 

The following lint call: 

lint -b myfile 

checks the consistency of the file 'myfile'. The -b option indicates that unreachable break state¬ 
ments are to be checked. 

PILES 

/u8r/lib/lint/lint[12] 

/usr/Ub/lint/llib-lc.ln 
/usr/lib/lint/llib-lc 
/usr/lib/lint/lUb-lm.ln 
/ UBr/lib/lint/llib-j[m 
/usr/lib/lint/llib-lmp.ln 
/usr/lib/lint/llib-ltiii) 
lib-l*.ln 

SEE ALSO 
cc(l) 

Lint, a C Program Checker, m Programming Tools for the Sun Workstation. 

BUGd 

There are some things you just can’t get lint to shut up about. 


programs 

declarations for standard functions 
human-readable version of above 
declarations for math functions 
human-readable version of above 
declarations for multi-precision functions 
human-readable version of above 
library created with -C. 
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NAME 

In - make links 
SYNOPSIS 

In I -f ] ( 1 namel | name2 ] 

In name ... directoiy 

DESCRIPTIGN 

A link is a directory entry referring to a file or -another directory; the same file or directory 
(together with its ske, all its protection information, etc.) may have several links to it. There are 
two kinds of links: bard links and symbolic links. 

Ln makes hard links by default. A -hard link to a file or directory is indistinguishable from the 
original directory entry; any changes to a file or directory are effective independent of the name 
used to reference the file or directory. Hard links may not span file systems. 

Given one or two arguments, in creates a link to an existing file or directory namel. If nameS w 
given, the link has that name; name2 may also be a directoiy in which to place the link; otherwise 
it is plau;ed in the current directory. If nameg is omitted or is a directory, the link made will have 
the same name as the last component of namel. 

Given more than two arguments, the last argument must be the name of a directory. In this case. 
In makes links to all the named files in the named directory. The links made will have the same 
name as the files being linked to. 

OPTIONS 

-f Force a hard link to a directory. The -f option is only available to the super-user. 

-• Create symbolic links. A symbolic link contains the name of the file or directoiy to 

which it is linked. The referenced file or directory is used when an open(2) operation is 
performed on the link. A etat{2) on a symbolic link returns the linked-to file; an btat{2) 
must be done to obtain information about the link. The readlink{2) call may be used to 
read the contents of a symbolic link. Symbolic links may span file systems and may refer 
to directories. 

EXAMPLES 

The commands below illustrate the effects of the different forms of the In command. 
mar6% In —F See what files we’ve got 

grab Jones/ 

mars% b —F Jones See what files there are in Jones 

house One file 

mars% In grab try to link a Jile in the same directory 

./grab: File exists Sorry — can’t link a Jile to itself 

mars% In Jones/house link a file from another directory to here 

mars% b -F 
grab house. Jones/ 

mars% In grab hold link a file to another name in this directory 

mar8% b -F 

grab hold house Jones/ 

mars% In grab hold Jones link files from here to Jones 

mars% b —F Jones 
grab hold house 
mar8% 

SEE ALSO 

rm(l), cp(l), mv(l), link(2), readlink(2), 8tat(2), symlink(2) 

BUGS 

Enor message.s print the wrong file name when the —s option is used. 
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NAME 

lockscreeo - maintain window context until “login” 

SYNOPSIS 

lockacreen (-e ] (-r ] 

DESCRIPTION 

Lockecreen maintains the user’s window setup and context. The user does not need to log out 
from the machine. When run with the machine not in use, the black lockecreen display and con¬ 
stantly moving Sun Microsystems logo limit phosphorus bum of the video display that may occur 
from running the same window configuration for a long time. 

L ockecreen should be executed from a terminal emulator running inside the SunWindows system. 
The window described by the environment parameter WINDOW_PARENT (such as, fdevImnO) 
is covered and obscured by black. This window is typically the entire screen. When any key¬ 
board or mouse button is pressed, the black screen is replaced by an option and message subwin¬ 
dow. The message subwindow (the top subwindow) prompts the user to fill in the Name and 
Pattword text items in the option subwindow (the bottom subwindow). See «unfoo/9(l) for a gen¬ 
eral description of interacting with option subwindows. Only root and the user name that 
invoked loektcreen are acceptable names. Initially, the user name is filled in and the password is 
the text item to which typed characters are directed. 

Once the name and password are entered, the user can use the mouse to choose the Show Deektop 
command item. If the name and password are valid, lockecreen terminates and reveals the win¬ 
dows under it. 

At any tim^, the user cih choose the Abort Login command item, which replaces the subwindows 
with the dark background and the logo. 

Also, at any time, any user can choose the Exit Deektop command item, which is analogous to 
choosing the Exit menu item in the Root Manager menu of the sun(oo/s(l) program. The pro¬ 
gram from which euntoole{l) executed is then in control of the machine. Notice that if eun- 
(oofo(l) was started from some program other than togin{l), whoever is sitting at the terminal is 
now logged in as the person that started euntoole{l). To prevent a breach of security, the -e 
command line switch can be given to lockecreen to suppress the display of the Exit Deektop com¬ 
mand item. 

OPTIONS 

-« Add* (he display of the Exit Deektop command item. The default is no exit option. 

-r Sodi^ne correctly logging in as root may invoke the Show Deektop command option. The 

default is thi^ this feature is disabled. 

SEE ALSO 

8untoob(l), login(l) 
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NAME 

login - sign on 

SYNOPSIS 

togiii ( username I 

DESCRa»TlON 

Lofin signs u$etitame on to tlie system initially; hgin may aliw be used at any time to change 
from one user i.d. to another. 


If you use login withMt sm argument, login requesto a user name, and a password appropriate. 
Echoing is turned off ^f possible) during the typing of the password, so it wiD not appear on the 
written record of the senion. 


After a successful login, accounting flies are updated, the user is informed of the existence of mail, 
and the message of the day is printed, as is the time he last logged in (unless he has a .kuoklogin 
flle in his home directory - this is mainly used to make life easier for non-human users, such as 
uuep). 

Login initializes the user and group IDs and the working directory, then executes a command 
interpreter (usually rA(l)) according to speciflcations found in a password flle. Argument 0 of the 
command interpreter is “-sh", or more generally the name of the command interpreter with a 
leading dash (“-”) prepended. 

Login also initializes the environment envtr«n(5) with information specifying home directory, 
command interpreter, terminal type (if available) and user name. 

If the flle fetef nologin exists, login prints its contents on the user’s terminal and exits. This is 
used by 9ktttdovm{8) to stop logins when the system is about to go down. 

Login is recognized by «h(l) and c«h(l) and executed directly (without forking). 

Login times out and exits if its prompt for input is not answered within some ‘reasonable* time. 


FILES 


/etc/utmp 

/usr/adm/wtmp 

/usr/spool/mail/* 

/etc/motd 

/etc/passwd 

/etc/nologin 

.hushlogin 

/etc/securetty 


accounting 

accounting 

mail 

message-of-tbe-day 

password flle 

stops logins 

makes logm quieter 

lists ttys that root may log in on 


SEE ALSO 

init(8), getty(8), mail(l), passwd(l), pas8wd(5), environ(5), shutdown(8) 


DIAGNOSTICS 

“Login incorrect,” if the name or the pamword is bad (or mis-typed). 

“No Shell”, “cannot open password flle”, "no directory”: consult a programming counselor. 
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NAME 

look - find lines in a sorted list 
SYNOPSIS 

look I -df I string { file ] 

DESCRIPTION 

Look consults a sorted file and prints all lines that begin with otring. 

OPTIONS 

-d ‘Dictionary’ order: only letters, digits, tabs and blanks participate in comparisons. 

-t Fold: Upper c^ase letters compare equal to lower case. 

If no file is specified, look uses luerldictlwordt with collating sequence -df. 

FILES 

/usr/dict/words 

SEE ALSO 

8ort(l), grep(l) 


o 
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NAME 

lorder - find ordering relation for an object library 

SYNOPSIS 

lorder file... 

description 

Give lorder one or more object or library archive (see ar(l)) filet, and it lists ps^n of object file 
names — meaning that the first file of the pair refers to external identifiers defined in the second 
— to the stmidard output. Lorder's output may be processed by <sor((l) to find an ordering of a 
library suitable for one-pass access by 

EXAMPLE 

This brash one-liner intends to build u new library from existing .0 files, 
ar cr library ' lorder *.0 | tsort' 

The ran/fl!(l), command converts an ordered archive into a randomly accessed library and makes 
lorder unnecessary . 

SEE ALSO 

t8ort(l), ld(l), ar(l), rMlib(l) 

BUGS 

The names of object files, in and out of libraries, must end with '.o’; otherwise, nonsense results. 
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NAME 

Ipq - spool queue examination program 
SYNOPSIS 

Ipq [ +( nutn ) ) ( -11 ( -Vprinter J | joh # ...) ( user ... I 
DESCRIPTION 

Ipq examines the spooling area used by lpd{S) for printing files on the line printer, and reports the 
status of the specified jobs or all jobs associated with a user. 

Lpq reports on any jobs currently in the queue when invoked without any options. See the 
OPTIONS section below for a list of options. Arguments supplied that are not recognized as 
options are interpreted as user names or job numbers to filter out only those jobs of interest. 

For each job submitted (that is, invocation of /pr(l)) Ipq reports the user’s name, current rank in 
the queue, the names of files comprising the job, the job identifier (a number which may be sup¬ 
plied to lprm{l) for removing a specific job), and the total size in bytes. The -1 option causes 
information about each of the files comprising the job to be printed. Normally, only as much 
information as will fit on one line is displayed. Job ordering is dependent on the algorithm used 
to scan the spooling directoiy and is supposed to be FIFO (First in First Out). File names 
comprising a job may be unavailable (when /pr(l) is used as a sink in a pipeline) in which case the 
file is indicated as '(standard input)’. 

If lpq warns that there b no daemon present (that is, due to some malfunction), the lpc(S) com¬ 
mand can be used to restart the printer daemon. 


OPTIONS 

Lpq reports on any jobs currently in the queue when invoked without any options. 

-Ppnn^er 

route the output to the printer specified by printer. In the absence of the -P option, the 
default line printer is used (or the value of the PRINTER variable in the environment). 

-l-nnn dbplay the spool queue until it empties. Supplying a number nnn immediately after the 
+ sign indicates that lpq should sleep nnn seconds in between scans of the queue. 


FILES 

/etc/termcap 
/etc/printcap 
/usr/spool/* 
/u8r/spool/*/cf* 
/usr/spool/’•'/lock 


for manipulating the screen for repeated display 

to determine printer characterbtics 

the spooling directory, as determined from printcap 

control files specifying jobs 

the lock file to obtain the currently active job 


SEE ALSO 

Ipr(l), Iprin(l), lpc(8), lpd(8) 


BUGS 

The 4* option doesn’t wait until the entire queue b empty; it only waits until the local machine’s 
queue b empty. 

Due to the dynamic nature of the information in the spooling directory lpq may report unreliably. 

Output formatting b sensitive to the line length of the terminal; this can result in widely-spaced 
columns. 


lpq b sometimes unable to open various files because the lock file is malformed. 


DIAGNOSTICS 

waiting for printer to become ready 

The daemon could not open the printer device. This can happen for a number of reasons; 
the most common is that the printer is turned off-line. This message can also be gen¬ 
erated if the printer is out of paper, the paper is jammed, and so on. The actual reason is 
dependent on the meaning of error codes returned by ^stem device driver. Not all 
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printers supply sufficient information to distinguish when a printer is off-line or having 
trouble (for example, a printer connected through a serial line). Another possible cause of 
this message is some other process, such as an output filter, has an exclusive open on the 
device. Your only recourse here is to kill off the offending program(s) and restart the 
printer with (pc. 

printer Is ready and printing 

The Ipq program checks to see if a daemon process exists for printer and prints the file 
status. If the daemon is hung, a super user can use Ipc to abort the current daemon and 
start a new one. 

wsdtlng tor host to come up 

Indicates that there is a daemon trying to connect to the remote machine named host in 
order to send the files in the local queue. If the remote machine is up, Ipd on the remote 
machine is probably dead or hung and should be restarted as mentioned for /pr. 

sending to host 

The files should be in the process of being transferred to the remote host. If not, the local 
daemon should be aborted and started with Ipe, 

Warnings printer Is down 

The printer has been marked as being unavailable with Ipe. 

Warnings no daemon present 

The ipd process overseeing the spooling queue, as indicated in the ‘Uock” file in that 
directory, does not exist. This normally occurs only when the daemon has unexpectedly 
died. The error log file for the printer should be checked for a diagnostic from the 
deceased process. To restart an Ipd, use 

% Ipe restart printer 
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NAME 

Ipr - off line print 
SYNOPSIS 

Ipp I -Ppnnier ] ( -#niim j [ --Cclaee ) j ~Jjob ] ( -Ttitle J j -1( num) j [ -1234/oni) [-wnum ] 

[ -pltndgvcftrmhs ] [ filename ... ] 

DESCRIPTION 

Lpr uses a spooling daemon to print the named files when facilities become available. If no 
names appear, the standard input is assumed. 

OPTIONS 

-P Force output to the named printer. Normally, the default printer is used (site depen¬ 
dent), or the value of the environment variable PRINTER is used. 

—# Produce multiple copies of output, using num as the number of copies for each file 

named. For example, 

% lpr -#3 foo.c bar«c morex 

produces three copies of the file foo.c, followed by three copies of bar.c, etc. On the 
other hand, 

% eat foo.c bar.c more.e j lpr -#3 
generates three copies of the concatenation of the files. 

-C Print class as tixe job classification on the burst page. For example, 

% lpr -C EECS foo.e 

replaces the ^stem name (the name returned by Aosfname(l)) with EECS on the burst 
page, and prints the file foo.c. 

-J Print job as the job name on the burst page. Normally, lpr uses the first file’s name. 

-T Use title instead of the file name for the title used by pr(l). 

-I Indent output num spaces. If num is not given, eight spaces are used as default. 

—1234 Mount the specified font on font position i. The daemon will construct a .railmag file 

referencing / usrf lib/vfontj name.size. 

-w Use num as the page width for pr. 

The following single letter options are used to notify the line printer spooler that the files are not 
standard text files. The spooling daemon will use the appropriate filters to print the data accord¬ 
ingly. 

—p Use pr(l) to format the files (equivalent to print). 

-1 Print control characters and suppress page breaks. 

—t The files contain data from troffil) (cat phototypesetter commands). 

-n The files contain data from ditroff {de\ice independent troff). 

-d The files contain data from iex{^ (DVI format from Stanford). 

-g The files contain standard plot data as produced by the p/o^(3X) routines (see also 
p/o<(lG) for the filters used by the printer spooler). 

-V The files contain a raster image for devices like the Benson Varian. 

—c The files contain data produced by cifplotlj). 

-f Interpret the first character of each line as a standard FORTRAN carriage control char¬ 
acter. 
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The remaining single letter options are: 


-r Remove the file upon completion of spooling. 

-m Send mail upon completion. 

-h Suppress the printing of the burst page. 

-8 Use »yndink{2) to link data files rather than trying to copy them (so large files can be 
printed). This means the files should not be modified or removed until they have been 
printed. 


FILES 

/etc/passwd 

/etc/printcap 

/usr/lib/lpd* 

/usr/spool/* 

/usr/spool/*/cf* 

/usr/spool/*/df* 

/usr/spool/*/tf* 

SEE ALSO 


personal identification 
printer capabilities data base 
line printer daemons 
directories used for spooling 
daemon control files 
data files specified in “cf” files 
temporary copies of “cf files 


Ipq(l), Iprm(l), pr(l). synilink(2), printcap(5), lpc(8), lpd(8) 


DIAGNOSTICS 

Iprt printer t unknown printer 

The printer was not found in the printeap database. Usually this is a typing mistake; 
however, it may indicate a missing or incorrect entry in the Jetcf printeap file. 

Iprt printer t Jobs queued* but eamnot start daemon. 

The connection to Ipd on the local machine failed. This usually means the printer server 
started at boot time has died or is hung. Check the local socket fdevf printer to be sure it 
still exists (if it does not exist, there is no tpd process running). Use 

% ps ax I fgrep Ipd 

to get a list of process identifiers of running Ipd’s. The Ipd to kill is the one which is not 
listed in any of the “lock” files (the lock file is contained in the spool directory of each 
printer). Kill the master daemon using the following command. 

% kUl pid 

Then remove fdevf printer and restart the daemon (and printer) with the following com¬ 
mands. 

% rm /dev/prlnter % /usr/llb/lpd 

Another possibility is that the Ipr program is not setuid root, setgid opooling. This can be 
checked with 


% Is -Ig /usr/ueb/lpr 

Ipr: printer: printer queue Is disabled 

This means the queue was turned off with 

% Ipe disable printer 

to prevent Ipr from putting files in the queue. This is normal^ done by the ^stem 
manager when a printer is going to be down for a long time. The printer can be turned 
back on by a super-user with Ipe. 
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NAME 

Iprm - remove jobs from the line printer spooling queue 
SYNOPSIS 

Iprm ( -Pprinter 1 (- 1 { # . • j ( user j 

DESCRIPTION 

Lprm removes a Job, or jobs, from a printer’s spool queue. Since the spooling directory is pro¬ 
tected from users, using Iprm is normaUy the only method by which a user may remove a job. 

Lprm without any arguments will delete the currently active job if it is owned by the user who 
invoked lprm. 

If the - flag is specified, lprm will remove all jobs which a user owns. If the super-user employs 
this fiag, the spool queue will be emptied entirely. The owner is determined by the user’s login 
name and host name on the machine where the Ipr command was invoked. 

Specifying a user’s name, or list of user names, will cause lprm to attempt to remove any jobs 
qqeued belonging to that user (or users). This form of invoking lprm is useful only to the super- 
user. 

A user may dequeue an individual job by specifying its job number. This number may be 
obtained from the lpq(l) program. For example: 

tutorial% Ipq -Plmagen 
imagen is ready and printing 

Rank Owner Job Files Total Size 

active wendy 385 standard input 35501 bytes 

tutorial% lprm -Plmagen 305 

Lprm announces the names of any files it removes and is silent if there are no jobs in the queue 
which match the request list. 

Lprm will kill off an active daemon, if necessary, before removing any spooling files. If a daemon 
is killed, a new one is automatically restarted upon completion of file removals. 

The — P option may be used to specify the queue associated with a specific printer (otherwise the 
default printer, or the value of the PRINTER variable in the environment is used). 

FILES 

/etc/printcap printer characteristics file 

/usr/spool/* spooling directories 

/usr/spool/’^/lock lock file used to obtain the pid of the current 

daemon and the job number of the currently active job 

SEE ALSO 

Ipr(l), Ipq(l), lpd(8) 

DIAGNOSTICS 

Iprmt printeri cannot restart printer daemon 

The connection to tpd on the local machine failed. This usually means the printer server 
started at boot time has died or is hung. Check the local socket / devfprinter to be sure it 
still exists (if it does not exist, there is no Ipd process running). Use 

% ps sot I fgrep Ipd 

to get a list of process identifiers of running Ipd’s. The Ipd to kill is the one which is not 
listed in any of the “lock” files (the lock file is contained in the spool directory of each 
printer). Kill the master daemon using the following command. 

% kill pid 
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Then remove f deviprinter and restart the daemon (and printer) with the following com¬ 
mands. 

% rm /dev/prlnter % /usr/llb/Ipd 

Another possibility is that the Ipr program is not setuid root, setgid tpooling. This can be 
checked with 

% la -Ig /usr/ucb/lpr 

BUGS 

Since there are race conditions possible in the update tA the lock file, the currently active job may 
be incorrectly identified. 
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NAME 

Is - list contents of directory 
SYNOPSIS 

la ( -acdfgUqrstulACLFR ] name ••• 

DESCRIPTION 

For each name which is a directory, te lists the contents of the directory; for each name which is a 
file, b repeats its name and any other information requested. By default, the output is sorted 
alphabetically. When no argument is given, the current directory is listed. When several argu¬ 
ments are given, the arguments are first sorted appropriately, but file arguments are processed 
before directories and their contents. 

OPTIONS 

There are a large number of options: 

-1 List in long format, giving mode, number of links, owner, size in bytes, and time of last 
modification for each file. (See below.) If the file is a special file the size field will instead 
contain the major and minor device numbers. If the file is a symbolic link the pathname 
of the linked-to file is printed preceded by 

-g Include the group ownership of the file in a long output. 

-t Sort by time modified (latest first) instead of by name. 

List all entries; in the absence of this option, entries whose names begin with a period (•) 
are not listed^. „ 

-8 Give size in kilobytes of each file. 

-d If argument is a directory, list only its name; often used with -1 to get the status of a 
directory. 

If argument is a symbolic link, list the file or directory the link references rather than the 
link itself. 

—r Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

-u Use time of last access instead of last modification for sorting (with the -t option) and/or 

printing (with the -1 option). 

-c Use time of file creation for sorting or printing. 

-1 For each file, print the i-number in the first column of the report. 

—f Force each argument to be interpreted as a directory and list the name found in each 

slot. This option turns off -1, -t, -89 and -r, and turns on -a; the order is the order in 
which entries appear in the directory. 

—F Mark directories with a trailing symbolic links with a trailing and executable files 

with a trailing 

-R Recursively list subdirectories encountered. 

-1 Force one entry per line output format; this is the default when output is not to a termi¬ 
nal. 

-C Force multi-column output; this is the default when output is to a terminal. 

-q Force printing of non-graphic characters in file names as the character '?’; this is the 

default when output is to a terminal. 

INTERPRETATION OF LISTING 

The mode printed under the —1 option contains 11 characters which are interpreted as follows: the 
first character is 

d if the entry is a directory; 


Sun Release hi 


Last change: 12 December 1983 


179 




LS(1) 


USER COMMANDS 


LS(1) 


b if the entry is a block*type special file; 
c if the entry is a character-type special file; 

1 if the entry is a symbolic link 
s if the entry is an AF_UNIX domain socket, or 

- if the entry is a plain file. 

The next 9 characters are interpreted as three sets of three bits each. The first set refers to owner 
permissions; the next to permissions to others in the same user-group; and the last to all others. 
Within each set the three characters indicate permission respectively to read, to write, or to exe¬ 
cute the file as a program. For a directory, ^execute’ permission is interpreted to mean permission 
to search the directory. The permissions are indicated as follows: 

r if the file is readable; 
w if the file is writable; 

X if the file is executable; 

— if the indicated permission is not granted. 

The group-execute permission character is given as a if the file has the set-group-id bit set; like¬ 
wise the user-execute permission character is given as a if the file has the set-user-id bit set. 

The last character of the mode (normally ‘x’ or is t if the 1000 bit of the mode is on. See 
cAm(?(/(l) for the meaning of this mode. 

When the sizes of the files in a directory are listed, a total count of blocks, including indirect 
blocks is printed. 

FILES 

/etc/passwd to get user id’s for ‘7s -1”, 

/etc/group to get group id’s for “te -g”, 

BUGS 

Newline and tab are considered printing characters in file names. 

The output device is assumed to be 80 columns wide. 

The option setting based on whether the output is a teletype is undesirable as “/s -a” is much 
different than “/s—aj Ipr”. On the other hand, not doing this setting would make old shell 
scripts which used la almost certain losers. 
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NAME 

m4 - macro processor 

SYNOPSIS 

m4 [ file •. • ] 

DESCRIPTION 

M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each argu* 
ment file is processed in order; the standard input is read if there are no arguments or if an argu¬ 
ment is The processed text is written on the standard output. 

Macro calls have the form 

name(argl,arg2, .. . , argn) 

The *(’ must immediately follow the name of the macro. If a defined macro name is not followed 
by a it is deemed to have no arguments. Leading unquoted blanks, tabs, and newlines are 
ignored while collecting arguments. Potential macro names consist of alphabetic letters, digits, 
and underscore where the first character is not a digit. 

Left and right single quotes ('") are used to quote strings. The value of a quoted string is the 
string stripped of the quotes. 

When a macro name is recognized, its arguments are collected by searching for a matching right 
parenthesis. Macro evaluation proceeds normally during the collection of the arguments, and any 
commas or right parentheses which happen to turn up within the value of a nested call are as 
effective as those in the original input text. After argument collection, the value of the macro is 
pushed back onto the input stream and rescanned. 

M4 makes available the following built-in macros. They may be redefined, but once this is done 
the original meaning is lost. Their values are null unless otherwise stated. 

define The second argument is installed as the value of the macro whose name is the first 
argument. Each occurrence of $n in the replacement text, where n is a digit, is 
replaced by the n-th argument. Argument 0 is the name of the macro; missing argu¬ 
ments are replaced by the null string. 

undefina removes the definition of the macro named in its argument. 

Ifdef If the first argument is defined, the value is the second argument, otherwise the third. 

If there is no third argument, the value is null. The word nnix is predefined on UNIX 
versions of m^, 

ehangequota 

Change quote characters to the first and second arguments. Changequote without 
arguments restores the originsJ values (that is, ^"). 

divert M4 maintains 10 output streams, numbered 0-9. The final output is the concatenation 
of the streams in numerical order; initially stream 0 is the current stream. The divert 
macro changes the current output stream to its (digit-string) argument. Output 
diverted to a stream other than 0 through 9 is discarded. 

undivert causes immediate output of text from diversions named as arguments, or all diversions 
if no argument. Text may be undiverted into another diversion. Undiverting discards 
the diverted text. 

returns the value of the current output stream, 
reads and discards characters up to and including the next newline. 

has three or more arguments. If the first argument is the same string as the second, 
then the value is the third argument. If not, and if there are more than four argu¬ 
ments, the process is repeated with arguments 4, 5, 6 and 7. Otherwise, the value is 
either the fourth string, or, if it is not present, null. 


diviiu];a 

dnl 

Ifelse 
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iner 

eval 

len 

Index 

•ubxtr 


translit 

Include 

sinelude 

■yscmd 


returns the value of its argument incremented by 1. The value of the argument is cal¬ 
culated by interpreting an initial digit-string as a decimal number. 

evaluates its argument as an arithmetic expression, using 32-bit arithmetic. Operators 
include + /, %, " (exponentiation); relationals; parentheses. 

returns the number of characters in its argument. 

returns the position in its first argument where the second argument begins (zero ori¬ 
gin). or -1 if the second argument does not occur. 

returns a substring of its first argument. The second argument is a zero origin number 
selecting the first character; the third argument indicates the length of the substring. 
A missing third argument is taken to be large enough to extend to the end of the first 
string. 

transliterates the characters in its first argument from the set given by the second 
argument to the set given by the third. No abbreviations are permitted. 

returns the contents of the file named in the argument. 

is identical to include, except that it says nothing if the file is inaccessible. 

executes the UNIX command given in the first argument. No value is returned. 


maketemp 

fills in a string of XXXXX in its argument with the current process id. 


errprint prints its argument on the diagnostic output file. 

dumpdef prints current names and definitions, for the named items, or for all if no arguments 
are given. 


SEE ALSO 

M4 —A Macro Proceosor, in Programming Tools for the Sun System. 
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NAME 

mail - send and receive mail 
SYNOPSIS 

maU ( -V ) ( -f I name ) ) ( people ... ] 

INTRODUCTION 

Mail is an intelligent, interactive facility for handling electronic mail. MaiVs basic unit of infor¬ 
mation is a message. Mail provides facilities for sending mail to other people, replying to mes¬ 
sages you receive from other people, and for browsing through received messages. 

Sending mail. To send a message to one or more other people^ use mail with arguments which 
are the names of people to send to. The people arguments can be the names of users on your own 
system, or they can be network addresses — see below. Then, type in your message, followed by 
an EOT (control-D) at the beginning of a line. The section l^elled Replying to or originating 
mail, describes some features of mail available to help you compose your letter. 

The -V option is a debugging aid for mail itself: it lets you see if your mail is being sent out OK. 

Reading mail. If you use maU without arguments, it checks your mail out of the post office, 
and then displays a one-line header of each message found there. The ‘current message’ is ini¬ 
tially the first message (numbered 1); you can display it with the print command (abbreviated 
p). You can move among the messages: use the ‘H- ’ command to move forward a message, the 
command to move back a message, and simple numbers to address a particular message. 

Disposing of mail. After examining a message you can delete (d) the message or reply (r) to 
it. Deleting a message makes maU forget about it. If you accidentally delete a message, you do 
have recourse: you can undelete (u) the message by giving its number, or you can exit (x) the 
mail session, leaving everything as it was before you started the session. Messages deleted during 
the mail session however, usually disappear and are never seen again. 

Specifying messages. Commands such as print and delete can be given a list of message- 
numbers as arguments to apply to a number of messages at once. Numbers in a list are separated 
by spaces. Message-numbers are simple numbers, or they can be specified as a range, that is, two 
numbers separated by a minus sign. Thus: 

ddete 1 2 

deletes messages 1 and 2, while: 
delete 1-5 

deletes messages 1 through 5. The special name addresses all messages, and addresses the 
last message; thus the top command (print the first few lines of a message) could be used in: 

top • 

to print the first few lines of all messages. 

Replying to or originating mail. You can use the reply (r) command to respond to mail 
from someone, r works somewhat like 
% msdl person 

but reply already knows that person is the person who sent you the message you’re replying to: 
type in the text of your message, and end the text with an EOT at the beginning of a line. There 
are some variations of the reply command: 

r (the straightforward reply command) replies to the person who sent you the message. 

This command can also be typed as replysender. 

R (upper-case R) replies to everyone who got the original message. This command can also 
be typed as replyaU. 

Also see the replyaU variable. 

While you are composing a message, you can use ‘escapes’ (usually called ‘tilde escapes’) to get 
maU to treat such lines in special ways. For instance, typing *~m’ (alone on a line) places a copy 
of the current message into the response, but shifted right by one tabs top. Other escapes set up 
subject fields, add and delete recipients to the message, and allow you to escape to an editor to 
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revise the message or to a shell to run some commands. These options are described in the sum¬ 
mary below. 

Ending a mail processing session. You end a maU session with the quit (q) command. 
Messages which have been examined but not deleted go to your mbox file. Messages which have 
been deleted are discarded. Unexamined messages go back to the post office. The -f option 
specifies that mat/ read in the contents of your m(ax (or the specified file) for processing; when 
you quit mail writes undeleted messages back to this file. 

Personal and systemwide distribution lists. You cmt create personal distribution lists so 
that, for instance, you can send mail to ‘cohorts’ and have it go to a group of people. Such lists 
can be defined by placing a line like: 

alias cohorts bill ozadp sklower jkf mark coiyrkridle 

in the file .mat/rc in your home directory. The current list of such aliases can be displayed by the 
alias (a) command in mat/. 

System Distribution Lists System wide distribution lists can be created by editing 
I usrf libf aliases, see a/tases(5) and sendmait{8); these are kept in a slightly different syntax. In 
mail you send, personal aliases are expanded in mail sent to others so that they can reply (lower 
case r) to the recipients. System-wide aliases are not expanded when the maU is sent, but any 
reply returned to the machine wUl have the system wide alias expanded as all mail goes through 
sendmail. If you edit fusrllib/aliases, you must run the program newaliases{8) to rebuild the 
aliases database. 

Network mail (ARPA, UUCP) Mail to sites on the ARPA or UUCP network can be sent using 
nameQsite for ARPA-net sites or machineluser for UUCP sites, provided appropriate gateways are 
known to the system. Be sure to escape the ! in UUCP sites when giving it on a csA command line 
by preceding it with a \. 

Mail has a number of options which can be set in the .mailre file to alter its behavior; thus 

net askee 

enables the ‘askcc’ (ask for carbon copy) feature. These options are summarized below in the sec¬ 
tion labelled Mail Options. 

SUMMARY OF MAIL COMMANDS 

This summary is adapted from the Mail User ^s Guide. 

Each mail command is typed on a line by itself. Arguments may follow the command word. The 
command word need not be typed in its entirety — the first command which matches the typed 
prefix is used. Commands which take message lists as arguments use the next message forward 
which satisfies the command’s requirements if a message-list is not specified. If there are no mes¬ 
sages forward of the current message, the search proceeds backwards, and if there are no good 
messages at all, mail types ‘No applicable messages’ and aborts the command. 

—[nnn] Go to the previous message and print it out. If the optional numeric argument nnn is 
specified, go to the nnn’th previous message and print it. 

-I-(nnn| 

Go to the next message and print it out. If the optional numeric argument nnn is 
specified, go to the nnn’th next message and print it. 

f Print a brief summary of commands. 

! Shell Command 

Execute the UNIX Shell Command which follows the !. 

alias (a) With no arguments, print out all currently-defined aliases. With one argument, print 
out that alias. With more than one argument, add the users named in the second and 
later arguments to the alias named in the first argument. 

chdir [directory] 
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(e) Change the user’s working directory to the optional directory argument. Change to 
the user’s login directory if directory is not specified. 

delete (d) Takes a list of messages as argument and marks them all as deleted. Deleted mes^ 
sages are not saved in mbox, nor are they available for most other commands. Messages 
deleted in the current mail session can be undeleted with the undelete command 
described later. 

dp (also dt) Delete the current message and print the next message. If there is no next mes¬ 
sage, mail says ‘at EOF.’ 

edit (e) Takes a list of messages and points the text editor at each one in turn. On return 
from the editor, the message is read back in. 

exit (ex or x) Effects an immediate return to the Shell without modifying the user’s ^stem 
mailbox, the mbox file, or the edit file when using the -f option. 

from (f) Takes a list of messages and prints their message headers. 

headers 

(h) List the current range of headers, 20 at a time (fewer lines are displayed on low-speed 
terminals). If you want to see another group of headers, you must type a number that 
lies within that group. For example, 

headers 

alone displays the headers of the first 20 messages. To see headers (say) 41 thru 60, you 
can type 

headers 45 

or in fact any number that lies in the range 41 thru 60. Also see the s command below, 
which scrolls forwards and backwards through groups of headers. 

help A synonym for ? 

hold (ho, also preserve) Takes a message list and marks each message therein to be saved in 
the user’s system mailbox instead of in mbox. Does not override the delete command. 

Ignore takes a list of character strings as arguments. Lines in the header of mail messages that 
start with any of the specified character strings are ignored. 

mall (m) Takes as arguments login names and distribution group names and sends mail to 
those people. 

next (n like + or CR) Goes to the next message in sequence and types it. With an argument 
list, types the next matching message. 

preserve 

A synonym for hold. 

print (p) Takes a message list and types out each message on the user’s terminal. Typing a 
print command with a capital P prints even ignored headers. 

quit (q) Terminate the mail session, saving all undeleted, unsaved messages in your mbox file 
in your login directory, preserving all messages marked with hold or preserve or never 
referenced in your system mailbox, and removing all other messages from your system 
maUbox. If new mail has arrived during the mail session, mail displays a message: 

You have new mall 

If you quit while editing a mailbox file with the -f flag, mail rewrites the edit file. Mail 
then returns to the Shell, unless the rewrite of edit file fails, in which case the user can 
escape with the exit command. 

reply (r) Takes a message list and sends mail to each message author just like the mail com¬ 
mand. The default message must not be deleted. 

replyall 
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Replies to all members on a distribution list, regardless of the setting of the reply all 
variable. 

replysender 

Reply to the sender of the message, regardless of the setting of the of the replyall vari¬ 
able. 

Reply (upper-case R) replies to all members on a distribution list, 
respond 

A synonym for reply. 

Respond 

A synonym for Reply. 

save (s) Takes a message list and a filename and appends each message in turn to the end of 
the file. The filename in quotes, followed by the line count and character count is echoed 
on the user’s terminal. 

set (se) With no arguments, prints all variable values. Otherwise, sets option. Arguments 
are of the form: 

option ssvalua 

or: 

option 

shell (sh) Invokes an interactive version of the shell. 

size Takes a message list and prints out the size in characters of each message, 
subject 

(su) works like the from command but works with subjects instead of message headers. 

top Takes a message list and prints the top few lines of each. The number of lines printed is 
controlled by the variable topllnes and defaults to five. 

type (t) A synonym for print, 
unalias 

Takes a list of names defined by alias commands and discards the remembered groups of 
users. The group names no longer have any significance. 

undelete 

(u) Takes a message list and marks each one as not being deleted. 

unset Takes a list of option names and discards their remembered values; the inverse of set. 

visual (v) Takes a message list and invokes the display editor on each message. 

write (w) is similar to the save command, but write removes the ‘From’ line and the ‘Status’ 
line from the header of the messages, whereas save leaves those lines in the message. 

xit (x) A synonym for exit. 

z Scrolls forwards and backwards through groups of headers, 20 at a time (fewer lines of 

headers on low-speed terminals). If a ‘+ ’ argument is given, the next 20 headers are 
displayed, and if a argument is given, the previous 20 headers are displayed. 

ESCAPE SEQUENCES 

Here is a summary of the tilde escapes, which are used when composing messages to perform spe¬ 
cial functions. Tilde escapes are only recognized at the beginning of lines. The name 
‘tilde escape’ is somewhat of a misnomer since the actual escape character can be set by the 
option escape. 

''Icommand 

Execute the indicated shell command, then return to the message. 

"'c name ... 
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Add the given names to the list of carbon copy recipients. 

*d Read the file deadJetter from your home directory into the message. 

'’e Invoke the text editor on the message collected so far. After the editing session is 

finished, you may continue appending text to the message. 

messages 

Read the named messages into the message being sent. If no messages are specified, read 
the current message. Also see the "m command which does the same thing but shifts the 
message right by one tab stop. 

"h Eklit the message header fields by typing each one in turn and allowing the user to 
append text to the end or modify the field by using the current terminal erase and kill 
characters. 

"m messages 

Read the named messages into the message being sent, shifted right one tab. If no mes¬ 
sages are specified, read the current message. 

*p Print out the message collected so far, prefaced by the message header fields. 

"q Abort the message being sent, copying the message to deadJetter in your home directory 
if save is set. 

"r filename 

Read the named file into the message. 

*s string 

Make the named string become the current subject field. 

"t name... 

Add the given names to the direct recipient list. 

“v Invoke an alternate editor (defined by the VISUAL option) on the message collected so far. 
Usually, the alternate editor is a screen editor. After you quit the editor, you may 
resume appending text to the end of your message. 

filename 

Write the message onto the named file. 

~ I command 

Pipe the message through the command as a filter. If the command gives no output or 
terminates abnormally, retain the original text of the message. The command fmt{l) is 
often used as command to rejustify the message. 

""string 

Insert the string of text in the message prefaced by a single If you have changed the 
escape character, then you should double that character in order to send it. 

MAIL OPTIONS 

Options are controlled via the set and unset commands. Options may be either binary, in which 
case it is only significant to see whether they are set or not, or string, in which case the actual 
value is of interest. You can set and unset options during a mail session, or you can place the 
options in your .mailre file in your home directory. 

Binary Options. Hie binary options include the following: 

append 

Messages saved in mboz are appended (the default case) to the end rather than 
prepended. This is set in /uer/lib/MaiLrc on version 7 systems, 

ask Mail prompts you for the subject of each message you send. If you respond with simply a 
newline, no subject field is sent. 
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aflkce Mail prompts for additional carbon copy recipients at the end of each message. Respond¬ 
ing with a newline indicates your satisfaction with the current list. 

autoprint 

The delete command behaves like dp — thus, after deleting a message, the next one is 
typed automatically. 

Ignore Mail ignores interrupt signals from your terminal and echoes them as @’s. 

metoo Usually, when a group is expanded that contains the sender, the sender is removed from 
the expansion. Setting metoo includes the sender in the group. 

nosave 

Prevents mail from saving messages in the deadJetter file in your home directory on 
receipt of two interrupts (or after a *’q). The default action is to save such messages in 
the deadJetter file. 

quiet Suppress printing the version of the mail program when first invoked, 
replyall 

Alters the action of the reply and Reply commands; reply (lower-case r) normally 
replies to just the sender of the message. Reply (upper-case R) normally replies to 
everyone on the distribution list. Setting the replyall variable reverses this behavior so 
that r (lower-case r) replies to everyone on the distribution list, and R (upper-case R) 
replies to Just the sender. This feature is here to retain compatibility with older versions 
of the mail system. 

String Options. The following options have string values: 

EDITOR 

Pathname of the text editor to use in the edit command and ~e escape. If not defined, 
then a default editor is used. The default editor is /usr/ueb/ex, 

SHELL Pathname of the shell to use in the ! command and the '^! escape. A default shell is used 
if this option is not defined. The default shell is Ibinfcah, 

VISUAL 

Pathname of the text editor to use in the visual command and > escape. 

escape If defined, the first character of this option gives the character to use in the place of to 
denote escapes. 

record If defined, gives the pathname of the file used to record all outgoing mail. If not defined, 
outgoing mail is not saved. 

toplines 

If defined, gives the number of lines of a message to be printed out with the top com¬ 
mand; normally, the first five lines are printed. 

crt If defined, gives the number of lines of a message to be printed before mail calls up the 
more(l) utility so that you can peruse the mail messages leisurely. 

EXAMPLES 

Send mail to Wendy on her system called ariel: 
angel% mall wendyQarlel 
Subject: New DBX Manuals 

The new DBX manual pages are In angel:/usr/man/manl/dbx.l 

"D 

EOT 

angel% 

Note that mail asked for a subject; this is controlled by the ask option in the .mailrc file. There 
is an example of such a file later on in this section. 


188 


Last change: 13 March 1984 


Sun Release 1.1 



MAIL(l) 


USER COMMANDS 


MAIL(l) 


Now when Wendy is working on her qrstem, she will see a mail notification: 
work, work, work 
Yon have new mail. 
ariel% mall 

Mail version 2.17 12/26/82. Type ? for help 
*/u8r/8pool/mail/wendy”: 1 message 1 new 

>N 1 cuthbert Thu Nov 3 10:03:01 11/265 "New DBX Manual Pages” 
& Main signah its readiness for commands 

Carriage-return means read next message 


From cuthbert Thu Nov 3 10:03:01 1983 
Date: 3 Nov 83 10:02:56 PST (Thu) 
From: cuthbert (Cuthbert Pouncetrifle) 
Subject: New DBX Manual Pages 
To: wendy 
Status: R 


The new DBX manual pages are in angeh/usr/man/manl/dbx.l 


& 

At EOF 
ft d 
ft q 
ariel% 


Mail signals its readiness for commands 
Carriage-return means read next message 
Means there are no more messages 
Delete this message 
Quit from the mail program 


Here is a •mailrc file in which you can set options to control mail’s behavior: 
set crt=30 ask 

ignore via apparently-to date from status received message-id 

The first line sets the ert option to 30 lines — if there are messages longer than this, mail calls up 
more to page through the message in 30-line chunks. The s«k option makes mail ask for a sub¬ 
ject heading every time you send mail to someone. Finally, the second line says to ignore any 
line starting with any of the character strings from the list — this shortens the amount of 
irrelevant junk that appears at the top of mail messages. 

Here is'a line from a .login file (oriented to the C-Shell): 
set mail=s(10 /usr/spool/maii/$USER) 

This set command instructs the C-Shell to look in fusrfspool/mailft USER tor mail every 10 
seconds and to notify you if there is mail waiting there. In the absence of the time specification, 
the Shell looks every five minutes. 


FILES 

/usr/spool/mail/* 

"/mbox 

■/.mailrc 

/tmp/R# 

/u8r/lib/Mail.help* 

/u8r/lib/Mail.rc 

/bin/mail 

/usr/Iib/sendmail 


post office 
your old mail 

file giving initial mail commands 
temporary for editor escape 
help files 

system initialization file 
to do actual mailing 
postman 


SEE ALSO 

binmail(l), fmt(l), Dewaliases(8), aliases(5), 8endmail(8), mailaddr(7), biff(l) 

Mail User’s Guide in the Beginner’s Guide to the Sun Workstation, which gives an excellent intro¬ 
duction. 
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For sendmaU installation instructions, see the Sun 5y«tem Manager’s Manual. 
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NAME 

make - mamtain program grouiw 
SYNOPSIS 

make (-f makc^c) (-I J (-k)(-n| |-t ] |-r J [-bv) [-d| |-pj (-S ) (-q) file... 
DESCRIPTION 

Make executes commands in makefile to update one or more target filee. File is typically a pro¬ 
gram. If no —f option is present, 'makefile* and 'Makefile* are tried in order. 'Makefile* with a 
capital M is the preferred choice since it appears towards the front of any list of files and thus 
tends to stand out. If makefile is make reads the standard input. More than one -f option 
may appear. 

Make updates a target if it depends on prerequisite files that have been modified since the target 
was last modified, or if the target does not exist. 

Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a 
blank-separated list of targets, then a colon, then a list of prerequisite files. Text following a 
semicolon, and all following lines that begin with a tab, are shell commands to be executed to 
update the target. If a name appears on the left of more than one 'colon* line, then it depends on 
all of the names on the right of the colon on those lines, but only one command sequence may be 
specified for it. If a name appears on a line with a double colon u then the command sequence 
following that line is performed only if the name is out of date with respect to the names to the 
right of the double colon, and is not affected by other double colon lines on which that name may 
appear. 

Two special forms of a name are recognized. A name like library{file) means the file named file 
stored in the archive named library, A name like library{{entry)) means the file stored in archive 
library containing the entry point entry. 

Sharp and newline surround comments. 

The following makefile says that program depends on the two files a.o and b.o and that they in 
turn depend on .c files and a common file called incl: 

program: a.o b.o 

cc a.o b.o -Im -o program 

a. o: incl a.c 

cc -c a.c 

b. o: incl b.c 

cc -c b.c 

Makefile entries of the form 
string! strings 

are macro definitions. Subsequent appearances of t{atringl) or ${9tringl} are replaced by etringS. 
If etringl is a single character, the parentheses or braces are optional. 

Make infers prerequisites for files for which makefile gives no construction commands. For exam¬ 
ple, a .c file may be inferred as prerequisite for a ,o file and be compiled to produce the .0 file. 
Thus the preceding example can 1^ done more briefly: 

program: a.o b.o 

cc a.o b.o -Im -o program 
a.o b.o: incl 

Prerequisites are inferred according to selected suffixes listed as the 'prerequisites’ for the special 
name .SUFFIXES; multiple lists accumulate; an empty list clears what came before. Order is 
significant; the first possible name for which both a file and a rule as described in the next para¬ 
graph exist is inferred. The default list is 

.SUFFIXES: .out .0 .c .e .r .f .y .1 .s .p 
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The rule to create a file with suffix $2 that depends on a similarly named file with suffix el is 
specified as an entry for the ‘target’ 8l82. Before issuing any command, make sets certain special 
macros: 

is set to the name of the file to be ‘made’. 

$? is set to the names of files that are younger than the target. 

$< is set to the name of the related file that caused the action, only if the command was gen¬ 

erated by an implicit rule. 

is set to the prefix shared by the current and dependent filenames, onl^^ if the command 
was generated by an implicit rule. 

For example, a rule for making optimized .o files from .c files is 
.c.o: ; cc -c -O -o $Q $*.c 

Certain macros are used by the default inference rules to communicate optional arguments to any 
resulting compilations. In particular, ‘CFLAGS’ is used for cc(l) options, ‘FFLAGS’ for /77(1) 
options, ‘PFLAGS’ for pc(l) options, and ‘LFLAGS’ and ‘YFLAGS’ for lex and yucc(l) options. 
In addition, the macro ‘WLAGS’ is filled in with the initial command line options supplied to 
make. This simplifies maintaining a hierarchy of makefiles as one may then invoke make on 
makefiles in subdirectories and pass along useful options such as -k. 

Command lines are executed one at a time, each by its own shell. A line is printed when it is 
executed unless the special target .SILENT is in makefile, or the first character of the command is 
*Q’. 

Commands returning nonzero status (see in^ru(l)) cause make to terminate unless the special tar* 
get .IGNORE is in makefile or the command begins with <tab><hyphen>. 

Interrupt and quit cause the target to be deleted unless the target is a directory or depends on the 
special name .PRECIOUS. 

OPTIONS 

-f myJUe 

myfiie is the name of the file to use for make commands instead of the default ‘makefile’ 
or ‘Makefile’. 

-1 Equivalent to the special entry .IGNORE:. 

-k When a command returns nonzero status, abandon work on the current entry, but con¬ 
tinue on branches that do not depend on the current entry. 

-n Trace and print, but do not execute the commands needed to update the targets. 

-t Touch, that is, update the modified date of targets, without executing any commands. 

-r Equivalent to an initial special entry .SUFFIXES: with no list. 

-s Equivalent to the special entry .SILENT:. 

-d debug; print internal state after each command 

-p print internal state after reading Makefile 

-q determines if the target is up to date — returns a zero exit status if it is, and a non-zero 

exit status otherwise. 

-S undoes the effect of the -k option. 

FILES 

makefile. Makefile 
SEE ALSO 

sh(l), touch(l), f77(l), pc(l) 

Make - A Program for Maintaining Computer Programo, in Programming Took for the Sun 


192 


Last change: 23 October 1983 


Sun Release 1.1 





MAKE(l) 


USER COMMANDS 
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System. 

BUGS 

Some commands return nonzero status inappropriately. Use -1 to overcome the difficulty. 
Commands that are directly executed by the shell, notably cd(l), are ineffectual across newlines in 
make. 

Make should recognize names of libraries in the dependency entries, for example: 


grab: -bn grab.o 

cc -o grab grab.o -Im 


Q 


Q 
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NAME 

man - print out manual pages; find manual information by keywords 
SYNOPSIS 

man [ - ] { ] ( section ] title • • • 

man —k keyword • •• 
man -f file ... 

DESCRIPTION 

Man displays information from the UNIX System Manuals. Man can be asked for one line 
descriptions of commands specified by name, or for all commands whose description contains any 
of a set of keywords. It can also provide on-line access to the sections of the printed manual. 

When neither the -k nor -f option is specified (see OPTIONS below), man formats a specified set 
of manual pages. If a section is specified, man looks in that section of the manual for the given 
titles. Section is an arabic section number (^3’ for instance); the number may be followed by a 
single letter classifier (*lg\ for instance, indicating a graphics program in Section 1). If section is 
omitted, man searches all sections of the manual, giving preference to commands over subroutines 
in system libraries, and prints the first section it finds, if any. 

If the standard output is a terminal, or if you use the - flag, man pipes its output through cal(l) 
with the -8 option to crush out useless blank lines, u/(l) to create proper underlines for different 
terminals, and through more(l) to stop after each page on the screen. Type a space to continue, 
and a control-D to scroll 11 more lines when the output stops. 

OPTIONS 

-k Display a one line synopsis of each manual section whose listing in the table of contents 
contains any of the keywords. 

FILES 

/usr/man/man?/* manual pages in nroffltroff^nxce 

/usr/man/cat?/* formatted manual pages 

SEE ALSO 

more(l), ul(l), whereis(l), catman(8) 

BUGS 

The manual is supposed to be reproducible either on the phototypesetter or on a typewriter. 
However, on a typewriter some information is necessarily lost. 


Attempt to locate manual sections related to those files, and display the table of contents 
lines for those sections. 

Use troff to format the specified section, assuming you have a suitable raster output dev- j, j 
ice which can actually handle troffs output. 
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NAME 

mesg permit or deny messages 

SYNOPSIS 

mesg[iij(y] 

DESCRIPTION 

Me«g with argument n forbids messages via ti;rtfe(l) by revoking non-user write permission on the 
user’s terminal. Meag with argument y reinstates permission. AU by itself, meag reports the 
current state without changing it. 

FILES 

/dev/tty* 

SEE ALSO 

write(I), talk(l) 

DIAGNOSTICS 

Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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NAME 

mkdir - make a directoiy 

SYNOPSIS 

mkdir dirname... 



DESCRIPTION 

Mkdir creates directories. Standard entries, for the directory itself, and .’ for its parent, are 
made automatically. 

The current umask(2) setting determines the mode in which directories are created. Modes may 
be modified after creation by using ehmod{l). 

Mkdir requires write permfesion in the parent directory. 

SEE ALSO 

chmod(l), rmdir(l), rm(l), umask(2), mkdir(2), rmdir(2) 
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NAME 

mkstr - create an error message file by massaging C source 
SYNOPSIS 

mkstr [ - ] messagefile prefix file«. . 

DESCRIPTION 

Mketr creates files of error messages. You can use mketr to make programs with large numbers of 
error diagnostics much smaller, and to reduce system overhead in running the program — as the 
error messages do not have to be constantly swapped in and out. 

Mkstr proc^es each of the specified filet, placing a massaged version of the input file in a file 
whose name consists of the specified prefix and the original name. A typical example of using 
mkstr would be: 

mkstr pistrings xx *.c 

This command would cause all the error messages from the C source files in the current directory 
to be placed in the file pitiringt and processed copies of the source for these files to be placed in 
files whose names are prefixed with xx. 

To proceu the error messages in the source to the message file, mketr keys on the string ‘error(”’ 
in the input stream. Each time it occurs, the C string starting at the is placed in the message 
file followed by a null character and a new-line character; the null character terminates the mes¬ 
sage so it can be easily used when retrieved, the new-line character makes it possible to sensibly 
eat the error message file to see its contents. The massaged copy of the input file then contains a 
leeek pointer into the file which can be used to retrieve the message, that is: 

char efilnameP s ’’/usr/lib/pi_strings’’; 
int efil =3 .1; 

error(al, a2, a3, a4) 

{ 

char buf{256]; 

lf(efil<0){ 

efil S3 open(efilname, 0); 
lf(efil<0){ 

oops: 

perror(efilname); 

exit(l); 

} 

} 

tf (lseek(efil, (long) al, 0) 11 read(efil, buf, 256) <» 0) 
goto oops; 

prmtf(buf, a2, a3, a4); 

} 

OPTIONS 

- Place error messages at the end of the specified message file for recompiling part of a large 
mkstr 'd program. 

SEE ALSO 

lseek(2), xstr(l) 
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NAME 

more, page *- browse through a text file 
SYNOPSIS 

more ( -cdflsu ] | -lines J ( +linenumber ] ( +/pattern ] | name ••• ) 
page ( -cdflsu j ( -lines ] ( +linenumber ] ( +/pattern ) ( name ••• J 
DESCRIPTION 

More is a filter which displays the contents of a text file one screenful at a time on a video termi¬ 
nal. It normally pauses after each screenful, and prints ‘-More-’ at the bottom of the screen. 
More displays another line if you type a carriage-return; more displays another screenful if you 
type a space. 

If you use the page command instead of the more command, the screen is cleared before each 
screenful is displayed (but only if a full screenful is being displayed), and k - I rather than k - 2 
lines are displayed in each screenful, where k is the number of lines the terminal can display. 

More looks in the file feteftermcap to determine terminal characteristics, and to determine the 
default window size. On a terminal capable of displaying 24 lines, the default window size is 22 
lines. 

More looks in the environment variable MORE to pre-set any flags desired. For example, if you 
prefer to view files using the -c mode of operation, the csh command ^setenv MORE -c” or the sh 
command sequence ^MORE^*-c\* export MORET would cause all invocations of more, including 
invocations by programs such as man to use this mode. Normally, the user will place the com¬ 
mand sequence which sets up the environment variable in the Aogin or .profile file. 

If more is reading from a file, rather than a pipe, a percentage is displayed along with the -More- 
prompt. This gives the fraction of the file (in characters, not lines) that has been read so far. 

Other sequences which may be typed when more pauses, and their effects, are as follows (t is an 
optional integer argument, defaulting to 1) : 

t<8pace> 

display i more lines, (or another screenful if no argument b given) 
dbplay 11 more lines (a ‘^scroll’’). If i is given, the scroll size is set to i. 
d same as "D (control-D) 

tz same as typing a space except that », if present, becomes the new window size. 

is skip t lines and print a screenful of lines 

if skip i screenfub and print a screenful of lines 
q or Q Exit from more. 

== Display the current line number. 

V Start up the editor vi at the current line, 
h Help command; give a description of all the more commands. 

i/expr search for the i-th occurrence of the regular expression ezpr. If there are less than i 
occurrences of ezpr, and the input is a file (rather than a pipe), the position in the file 
remains unchanged. Otherwise, a screenful is dbplayed, starting two lines before the 
place where the expression was found, or the end of the pipe, whichever comes first. The 
user’s erase and kill characters may be used to edit the regular expression. Erasing back 
past the first column canceb the search command. 

in search for the i-th occurrence of the last regular expression entered. 

* (single quote) Go to the point from which the last search started. If no search has been 

performed in the current file, thb command goes back to the beginning of the file. 
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Icommand 

invoke a shell with command. The characters and T in ’’command” are replaced with 
the current file name and the previous shell command respectively. If there is no current 
file name, *%* is not expanded. The sequences and ’’V” are replaced by and 
”!” respectively, 

j:n skip to the t-th next file given in the command line (skips to last file if n doesn’t make 
sense) 

i :p skip to the i-th previous file given in the command line. R this command is given in the 
middle of printing out a file, more goes back to the beginning of the file. If f doesn’t make 
sense, more skips back to the first file. If more is not reading from a file, the bell is rung 
and nothing else happens. 

:f display the current file name and line number. 

:qor:Q 

exit from more (same as q or Q). 

(dot) repeat the previous command. 

The commands take effect immediately; it is not necessary to type a carriage return. Up to the 
time when the command character itself is given, the user may type the line kill character to can¬ 
cel the numerical argument being formed. In addition, the user may type the erase character to 
redisplay the —More~(xx%) message. 

At any time when output is being sent to the terminal, the user can type the quit key (normally 
control-\). More stops sending output, and displays the usual -More- prompt. The user may 
then enter one of the above commands in the normal manner. Unfortunately, some output is lost 
when this b done, due to the fact that any characters waiting in the terminal’s output queue are 
flushed when the quit signal occurs. 

More sets the terminal to noecho mode so that the output can be continuous. Thus what you 
type does not show on your terminal, except for the / and ! commands. 

If the standard output^ is not a terminal, more acts just like cat, except that a header is printed 
before each file in a series. 

OPTIONS 

-/sues Set the size of the window to lines lines long instead of the default. 

-c Display each page by redrawing the screen instead of scrolling. Thb makes it easier to 
read text while more is writing. This option is ignored if the terminal does not have the 
ability to clear to the end of a line. 

-d Display the message ’Hit space to continue, Rubout to abort* at the end of each screenful. 
Thb is useful if more b being used as a filter in some setting, such as a class, where users 
are unsophbticated. 

-f Count logical rather than screen lines. That b, long lines are not folded. This option is 
recommended if nroff output is being piped through ul, since the latter may generate 
escape sequences. These escape sequences contain characters which would ordinarily 
occupy screen postions, but which do not print when they are sent to the terminal as part 
of an escape sequence. Thus more may think that lines are longer than they actually are, 
and fold lines erroneously. 

-1 Do not treat "L (form feed) specially. If is not used, more pauses after any line that 
contains a "L, as if the end of a screenful had been reached. Also, if a file begins with a 
form feed, the screen is cleared before the file b printed. 

—s Squeeze multiple blank lines from the output, and replace them with single blank lines. 

Especially helpful when viewing nro^^ output, thb option maximizes the useful informa¬ 
tion present on the screen. 
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-u Normally, mart handles underlining such as produced by nroffin a manner appropriate 

the particular terminsd; if the terminal can perform underlining or has a stand-out mode, 'Uar 
more outputs appropriate escape sequences to enable underlining or stand-out mode for 
underlined information in the source file. The -u option suppresses this processing. 

-|-/»ncnumJcr 

Start up at linenumber. 

’^-/pattern 

Start up two lines before the line containing the regular expression pattern. 


EXAMPLES 

A sample usage of more in previewing nrojf output would be 
nroff -ms + 2 doc.n | more -s 

FILES 

/etc/termcap Terminal data base 

/usr/lib/more.help Help file 

SEE ALSO 

C8h(l), man(l), script(l), sh(l), environ(5), termcap(5) 
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mt - magnetic tape manipulating program 
SYNOPSIS 

mt I -f lapename] command{ count] 

DESCRIPTION 

Mt sends commands to a magnetic tape drive. If a tape name is not specified, the environment 
vi^riable TAPE is used; if TAPE does not exist, mt uses the device jdevIrmtlS. Note that 
tafcnamc must reference a raw (not block) tape device. By default m( performs the requested 
owration once. Operations may be performed multiple times by specifying count. 

T^e available commands are listed below. Only as many characters as are required to uniquely 
i4^htify a command need be specified. 

eqif, weof 

Write count end>of>fiIe marks at the current position on the tape, 
fsf Forward space count files, 

far Forward space count records, 

bnf Back space count files, 

bar Back space count records, 

rewind 

Rewind the tape (Count is ignored.) 
oflSlne, rewofiB 

Rewind the t^e and place the tape unit off-line (Count is ignored.) 
atatua Print status information about the tape unit. 

Mt returns a 0 exit status when the operation(s) were successful, 1 if the command was unrecog¬ 
nised, and 2 if an operation failed. 

FILES 

/dev/rmt* Raw magnetic tape interface 

/dev/rar* Raw Archive cartridge tape interface 

/dev/rst* Raw SCSI tape interface 

SEE ALSO 

mtio(4), dd(l), ioctI(2), environ(5) 

BUGS 

Archive t^es are not full-fiedged tape devices, as they do not support the fsr, baf or bar options. 
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NAME 

mv - move or rename files 
SYNOPSIS 

mv 1 —111 -f 1 I - I filel file2 

mv 1 -i 1 1 1 (- 1 directoiyl directory2 

mv {-1 ] I -f ] I - ] file ... directory ... directory 
DESCRIPTION 

Mv moves files and directories around in the file system. A side effect of mv b to rename a file or 
directory. The three major forms of mv are shown in the synopsis above. 

The first form of mv moves (changes the name of) fieJ to If fileS already exists, it is 

removed before fileJ is moved. If JSeS has a mode which forbids writing, mv prints the mode (see 
chmo<i(2)) and reads the standard input to obtain a line; if the line begins with y, the move tidces 
place, otherwise mv exits. 

The second form of mv moves (changes the name of) directoryl to direetoryS, ONLY it direetoryS 
does not already exist — if it does, the third form applies. 

The third form of mv moves one or more filee and directoriet, with their original names, to the 
last directory in the Ibt. 

Mv refuses to move a file or directory onto itself. 

OPTIONS 
-I 


-f 


SEE ALSO 

cp(l), ln(l) 

BUGS 

If filel and file2 are on different file systems^ then mv must copy the file and delete the original. 
In this case the oivner name becomes that of the copying process and any linking relationship 
with other files is lost, 

Mv will not move a directory from one file system to another. 


interactive mode: mv displays the name of the file or directory followed by a question 
mark whenever a move would replace an existing file or directory. If you type a line 
starting with 'y\ mt; moves the specified file or directory, otherwise mu does nothing with 
that file or directory. 

force: override any mode restrictions and the -I switch. The -f option also suppresses 
any warning messages about modes which would potentially restrict overwriting. 

Interpret all the following arguments to mv as file names. This allows file names starting 
with minus. 
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NAN^ 

nice, nohup - run a command at low priority {gk only) 

SYNOPSIS 

nlca [ -number] command ( arguments ] 
nohup command ( arguments | 

DESCRIPTION 

Nice executes commend with low scheduling priority. If the number argument is present, the 
priority is incremented (higher numbers mean lower priorities) by that amount up to a limit of 20. 
The default number is 10. 

The super-user may run commands with priority higher than normal by using a negative priority, 
e.g. ‘—10’. 

Nohup executes command immune to hangup and terminate signals from the controlling terminal. 
The priority is incremented by 5. Nohup should be invoked from the shell with in order to 
prevent it from responding to interrupts by or stealing the input from the next person who logs in 
on the same terminal. The syntax of nice is also different. 

FILES 

nohup.out standard output and standard error file under nohup 
SEE ALSO 

csh(l), nice(3C), renice(8) 

DIAGNOSTICS 

Nice returns the exit status of the subject command. 

BUGS 

Nice and nohup are particular to sh(l). If you use e«A(l), then commands executed with are 
automatically immune to hangup signals while in the background. There is a builtin command 
nohup which provides immunity from terminate, but it does not redirect output to nohup.out. 

Nice is built into esk(l) with a slightly different syntax than described here. The form “nice 
•f 10” nices to positive nice, and “nice -10” can be used by the super-user to give a process more 
of the processor. 
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NAME 

nm - print name list 
SYNOPSIS 

nm ( -snoprua | { file ... ] 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argument list. If an argument is 
an archive, a listing for each object file in the archive will be produced. If no is given, the 
symbols in a.out are listed. 

Each symbol name is preceded by its value (blanks if undefined) and one of the letters: 

U (undefined), 

A (absolute), 

T (text segment symbol), 

D (data segment ^mbol), 

B (bss segment symbol), 

C (common symbol), 

f file name, 

- debug symbol table entries (see -a below). 

If the symbol is local (non-external) the type letter is in lower case. The output is sorted alpha¬ 
betically. 

OPTIONS 

-g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prepend file or archive element name to each output line rather than only once. 

-p Don’t sort; print in symbol-table order. 

-r Sort in reverse order. 

-u Print only undefined qrmbob. 

-a Print all symbols. 

EXAMPLE 

nm 

prints the symbol list of a.out, the default output file for the C compiler. 

SEE ALSO 

ar(l), ar(5), a.out(5) 
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NAME 

nroff - text formatting and typesetting 
SYNOPSIS 

nroff I -opageliat ) ( -nA^) ( ( -m name ] 1 -r oA^ J | -1 ] [ -q ] (-Tnome) 

[-«l|-hllfile)... 

DESCRIPTION 

Nroff formats text in the named JUet for typewriter>like devices. See also The full capa¬ 

bilities of nroff mi troffvtt described in Formatting Documents with Nroff and Troff. 

If no file argument is present, nroff teada the standard input. An argument consisting of a single 
minus (-) is taken to 1^ a file name corresponding to the standard input. 

OPTIONS 

Options ma^ appear in any order so long as they appear before the files. 

-pliet Print only pages whose page numbers appear in the comma-separated list of numbers and 
ranges. A range N-M means pages N through M; an initial -N means from the beginning 
to page N] and a final N- means from N to the end. 

-nN Number first generated page N. 

-»N Stop every N pages. Nroff will halt prior to every N pages (default N—l) to allow paper 
loading or changing, and will resume upon receipt of a newline. 

-mnsme 

Prepend the macro file /usr/IIb/tmae/tmae.name to the input files. 

-taN Set register a (one-character) to N. 

-i Read standard input after the input files are exhausted. 

-q Invoke the simultaneous input-output mode of the rd request. 

-Tname 

Prepare output for a device of the specified name. Known names are: 

37 Teletype Corporation Model 37 terminal — this is the default. 

tn300 GE TermiNet 300 (or any terminal without half-line capability), 

300S DASI-300S 

300 DASI-300 

300X DASI-300X 

450 DASI-450 (Diablo Hyterm). 

450-12 DASI-450 (Diablo Hyterm) — 12-pitch. 

45012-8 DASI-450 (Diablo Hyterm) — 12-pitch and 8 lines-per-inch. 

450X DASI-450X (Diablo Hyterm). 

Ipr Line printer. 

xl700 Xerox 1700 daisywheel printer. 

—e Produce equally-spaced words in adjusted lines, using full terminal resolution. 

-h Use output tabs during horizontal spacing to speed output and reduce output character 
count. Tab settings are assumed to be every 8 nominal character widths. 

EXAMPLE 

gaia% nroff -s4 -m« UBers.gu!de 

FormaU users.guide using the -me macro package, and stopping every 4 pages. 

FILES 

/tmp/ta* temporary file 

/usr/lib/tmac/tmac.* standard macro files 


Sun Release 1.1 


Last change: 14 December 1983 


205 







NROFF(l) 


USER COMMANDS 


NROFF(l) 


/usr/Ub/term/* terminal driving tables for nroff 

SEE ALSO 

Formatting Documentd with Nr off and Troffia Editing and Text Processing on the Sun Worksta¬ 
tion. 

troff(l), eqn(l), tbl(l), ms(7), me(7), man(7), col(l) 
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NAME 

od - octal, decimal, hex, ascii dump 
SYNOPSIS 

od I -format ] [ file ] [ [•f]off8et[.](b] [label] j 
DESCRIPTION 

Od displays file, or it’s standard input, in one or more dump formats as selected by the first argu¬ 
ment. If the first argument is missing, -o (octal) is the default. Dumping continues until end-of- 
file. 

The meanings of the format argument characters are: 

a Interpret bytes as characters and display them with their ASCII names. If the p character is 
given also, bytes with even parity are underlined. If the P character is given, bytes with 
odd parity are underlined. Otherwise the parity bit is ignored. 

b Interpret bytes as unsigned octal. 

e Interpret bytes as ASCII characters. Certain non-graphic characters appear as C escapes: 
nulla>\0, backspacea"\b, formfeed»\f, newlinev\n, returnss\r, tab—\t; others appear as 
3>digit octal numbers. Bytes with the parity bit set are displayed in octal. 

d Interpret (short) words as unsigned decimal, 
f Interpret long words as floating point, 
h Interpret (short) words as unsigned hexadecimal. 

1 Interpret (short) words as signed decimal. 

1 Interpret long words as signed decimal, 
o Interpret (short) words as unsigned octal. 

■|n] Look for strings of ASCII graphic characters, terminated with a null byte. N specifies the 
minimum length string to be recognized. By default, the minimum length is 3 characters. 

V Show all data. By default, display lines that are identical to the last line shown are not out¬ 
put, but are indicated with an in column 1. 

w[n| Specifies the number of input bytes to be interpreted and displayed on each output line. If 
w is not specified, 16 bytes are read for each display line. If n is not specified, it defaults to 
32. 

X Interpret (short) words as hexadecimal. 

An upper case format character implies the long or double precision form of the object. 

The effect argument specifies the byte offset into the file where dumping is to commence. By 
default this argument is interpreted in octal. A different radix can be specified; If is appended 
to the argument, then offaet is interpreted in decimal. If offaet begins with “x” or “Ox”, it is 
interpreted in hexadecimal. If “b” ("B") is appended, the offset is interpreted as a block count, 
where a block is 512 (1024) bytes. If the file argument is omitted, an offaet argument must be 
preceded t>y 

The radix of the displayed address will be the same as the radix of the offaet, if specified; other¬ 
wise it will be octal. 

Label will be interpreted as a pSeudo-address for the first byte displayed. It will be shown in “()” 
following the file offset. It is intended to be used with core images to indicate the real memory 
address. The syntax for label is identical to that for offaet. 

SEE ALSO 

adb(l) 
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BUGS 

A file name argument can’t start with “+ A hexadecimal offset can’t be a block count. Only 
one file name argument can be given. 

It is an historical botch to require specification of object, radix, and sign representation in a single 
character argument. 
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NAME 

pagesize - print aystem page size 

SYNOPSIS 

psgealae 

DESCRIPTION 

Pagerize prints the size of a page of memory in bytes, as returned by gttpage8izc(2). This pro¬ 
gram is useful in constructing portable shell scripts. 

SEE ALSO 

getpagesize(2) 


o 


o 
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NAME 

passwd - change login password 

SYNOPSIS 

passwd ( name) 

DESCRIPTION 

Thb command changes (or installs) a password associated with the user name (your own name by 
default). 

Pasiwd prompts for the old password and then for the new one. The caller must supply both. 
The new password must be typed twice, to forestall mistakes. 

New passwords must be at least four characters long if they use a sufficiently rich alphabet and at 
least six characters long if monocase. These rules are relaxed if you are insistent enough. 

Only the owner of the name or the super-user may change a password; the owner must prove he 
knows the old password. 

FILES 

/etc/passwd 
SEE ALSO 

login(l), passwd(5), crypt(3) 

Robert Morris and Ken Thompson, UNIX password security 

BUGS 

The password file information should be kept in a different data structure allowing indexed access; 
dim(3X) would probably be suitable. 
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NAME 

pc - P^al compiler 
SYNOPSIS 

Pel-«1 1-«1 |-p 1 l-O) I-S ] l-ootilpul) l-C) [-bj l-I] [-1] (-s) [ -*) 

I -Iname... ] name ... 

DESCRIPTION 

Pe is a Pascal compiler. If given an argument file ending with ,p, it compiles the file and loads it 
into an executable file called, by default, 

A program may be separated into more than one ,p file. Pc will compUe a number of argument .p 
files into object files (with the extension .e in place of .p). Object files may then be loaded into 
an executable a,out file. Exactly one object file must supply a progrtun statement to success¬ 
fully create an executable a.out file. The rest of the files must consist only of declarations which 
logically nest within the program. References to objects shared between separately compiled files 
are allowed if the objects are declared in Inelude’d header files, whose names must end with .h. 
Header files may only be included at the outermost level, and thus declare only globally available 
objects. To allow ftinetlons and procedures to be declared, an external directive has been 
added, whose use is similar to the forward directive but restricted to appear only in ,h files. 
Function and procedure bodies may not appear in .k files. A binding phase of the compiler 
checks that declarations are used consistently, to enforce the type checking rules of Pascal. 

Object files created by other language processors may be loaded together with object files created 
by pe. The ftinetlons and procedures they define must have been declared in .h files included 
by all the .p files which call those routines. Calling conventions are as in C, with var parameters 
passed by address. 

See the Pateal U$er'$ Manual in the Sun Fortran and Pascal Manual for details. 

OPTIONS 

The following options have the same meaning as in cc(l) and f77{l). See ld{l) for load-time 
options. 

-e Sut)pres8 loading and produce .9 file(s) from source file(8). 

-§ Produce additional symbol table information for dbx{l). 

-w Suppress warnifig messages. 

-p Prepare object files for profiling, see prof{l). 

-O Invoke an object-code improver. 

-8 Compile the named program, and leave the assembler-language output on the correspond¬ 
ing file with a ,e suffix. No .o is created. 

-o output 

Name the final output file output instead of amout. 

The following options are peculiar to pe. 

-C Compile code to perform runtime checks, verify assert statements, and initialize all vari¬ 
ables to zero as in pi. 

-b Block buffer the file output. 

—1 Produce a listing for the specified procedures, functions and Include files. 

4 

-1 Make a progfam listing during translation. 

—a Accept standard Pascal only; non-standard constructs cause warning diagnostics. 

-I Allow execution profiling with pxp by generating statement counters, and arranging for the 
creation of the profile data file pmoriuout when the resulting object is executed. 
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Other arguments are taken to be loader option arguments, perhaps libraries ot pc compatible rou¬ 
tines. Certain flags can also be controlled in comments within the program as described in the 
Pateal User ’« Manual in the Sun Fortran and Pascal Manual. 

FILES 

file.p 

/usr/lib/pcO 
/lib/fl 
/usr/lib/pc2 
/lib/c2 
/usr/lib/pcS 
/usr/lib/pc2.0strings 
/usr/lib/how_pc 
/usr/lib/libpc.a 
/usr/lib/libm.a 
/lib/libc.a 

SEE ALSO 

The Pascal User’s Manual in the Sun Fortran and Pascal Manual. 
pi(l), pxp(l), pxref(l) 

DIAGNOSTICS 

For a basic explanation do 

pc 

BUGS 

The packed keyword is recognized but has no effect. 

The -a flag doesn't work for separately compiled files. 

Because the -a option is usurped by the compiler, it is not possible to pass the strip option to the 
loader. Thus programs which are to be stripped, must be run through strip{l) after they are com- 
piled. 

The compiler qualifiles a nested procedure name by chaining the names of the enclosing pro¬ 
cedures. This sometimes results in names long enough to abort the assembler (ss(l)), which 
currently limits identifiers to 50 characters. 


pascal source files 

compiler 

code generator 

runtime integrator (inline expander) 
peephole optimizer 

separate compilation consistency checker 
text of the error messages 
basic usage explanation 
intrinsic functions and I/O library 
math library 

standard library, see infro(3) 
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NAME 

perfmon - graphical display of general qrstem statistics 
SYNOPSIS 

perfmon ( statistic . .. ] 

DESCRIPTION 

Perfmon provides a graphical display of the qrstem-wide performance statistics and updates them 
approximately once a second. It should be executed from a graphics tool inside the SunWindows 
system. The time interval between updates can be adjusted by typing one of the following char¬ 
acters while the mouse is in the graphics subwindow: 

• increases the interval by 0.05 seconds (small « means get slower by a little). 

S increases the interval by one second (capital 5 means get Slower by a lot), 

f decreases the interval by 0.05 seconds (small / means get /aster by a little). 

F decreases the interval by one second (capital F means get Faster by a lot). 

R resets the interval to the standard 1.05 seconds. 

In addition, typing: 

H, h or r 

lists the characters that perfmon is listening for. 

Q or q causes perfmon to cease executmg. 

If no statistic argument is given, perfmon displays all statistics. A tick is placed on the lines 
separating the graphs once every fifteen seconds (due to scheduling vagaries, these ticks may not 
be evenly spaced). 

Statbtles 

user is the percentage of total CPU time spent in normal and low priority user processes. 

system 

is the percentage of total CPU time attributed to system calls and overhead. 

Idle is the percentage of total CPU time spent idle, 
free is the amount of available real memory (in Kbytes), 
disk is the total number of disk transfers performed. 

Interrupts f ^ 

is the total nuinber of interrupts serviced. 

Input is the total number of input packets received, 
output 

is the total number of output packets transmitted, 
eolllslon 

is the total number of collisions between packets observed on the network. 

SEE ALSO 

netstat(8), vmstat(8), suntool8(l) 
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NAME 

pi - Pascal interpreter code translator 
SYNOPSIS 

pi I -b ) I -1) I -11 I -n 1 I -p 1 ( -8 ) I -t I I -u ] ( -w J I -a 11 -I name ... ) name.p 
DESCRIPTION 

Pi translates the program in the file name.p leaving interpreter code in the file obj in the current 
directory. The interpreter code can be executed using px. Pix performs the functions of pi and px 
tor ‘load and go’ Pascal. 

OPTIONS 

The following flags are interpreted by pi; the associated options can also be controlled in com¬ 
ments within the program as described in the Pascal User's Manual in the Sun Fortran and Pascal 
Manual. 

-b Block buffer the file output. 

-1 Enable the listing for any specified procedures and functions and while processing any 
specified Include files. 

-1 Make a program listing during translation. 

-n Begin each listed Include file on a new page with a banner line. 

-p Suppress the post-mortem control flow backtrace if an error occurs; suppress statement 
limit counting. 

-s Accept standard Pascal only; non-standard constructs cause warning diagnostics. 

-t Suppress runtime tests of subrange variables and treat assert statements as comments. 

—u Card image mode; only the first 72 characters of input lines are used. 

-w Suppress warning diagnostics. 

-s Allow execution profiling with pxp by generating statement counters, and arranging tor the 
creation of the profile data file pmon.out when the resulting object is executed. 

FILES 

flie.p input file 

file.i Include file(s) 

/usr/lib/pi2.*8tring8 text of the error messages 

/u8r/Iib/how_pi* basic usage explanation 

obj interpreter code output 

SEE ALSO 

Berkeley Pascal User’s Manual 
pix(l), px(l), pxp(l), pxref(l) 

DIAGNOSTICS ^ 

For a basic explanation do 

pi 

In the diagnostic output of the translator, lines containing syntax errors are listed with a flag indi¬ 
cating the point of error. Diagnostic messages indicate the action which the recoveiy mechanism 
took in order to be able to continue parsing. Some diagnostics indicate only that the input is 
‘malformed.* This occurs if the recovery can find no simple correction to make the input syntacti¬ 
cally valid. 

Semantic error diagnostics indicate a line in the source text near the point of error. Some errors 
evoke more than one diagnostic to help pinpoint the error; the follow-up messages begin with an 
ellipsis *...*. 
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The first character of each error message indicates its class: 

E Fatal error; no code will be generated, 

e Non-fatal error, 

w Warning - a potential problem, 

s Non-standard Pascal construct warning. 

If a severe error occurs which inhibits further processing, the translator wiU give a diagnostic and 
then‘QUIT. 

BUGS 

The keyword packed is recognized but has no effect. 

For clarity, semantic errors should be fiagged at an appropriate place in the source text, and mul¬ 
tiple instances of the ^sarne’ semantic error should be summarized at the end of a procedure or 
function rather than evoking many diagnostics. 

When include files are present, diagnostics relating to the last procedure in one file may appear 
after the beginning of the listing of the next. 
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NAME 

pix - Pascal interpreter and executor 



SYNOPSIS 

pix [ -blnpstuws ] ( -1 name ... ] name.p ( au^gument... ] 


DESCRIPTION 

Pix is a 4oad and go’ version of Pascal which combines the functions of the interpreter code 
translator pi and the executor px. It uses pt to translate the program in the file name.p and, if 
there were no fatal errors during translation, causes the resulting interpreter code to be executed 
by px with the specified arguments. A temporary file is used for the object code; the file ohj is 
neither created nor destroyed. 


FILES 

/usr/bin/pi 

/usr/bin/px 

/tmp/pix* 

/usr/lib/how^pix 


Pascal translator 
Pascal executor 
temporary 
basic explanation 


SEE ALSO 

The Pascal User *8 Manual in the Fortran and Pascal for the Sun Workstation Manual. 
pi(l), px(l) 


DIAGNOSTICS 

For a basic explanation do 

pix 


o 


o 
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NAME 

plot- graphics filters 
SYNOPSIS 

plot { ’^Tterminal [ raster ] ] 

DESCRIPTION 

These commands read plotting instructions (see p/ol(S)) from the standard input, and in general 
produce plotting instructions suitable for a particular fermtnaf on the standard output. 

If no terminal type is specified, the environment parameter TERM (see envtron(5)) is used. 
Knoum terminals are: 

4014 Tektronix 4014 storage scope. 

4S0 DASI Hyterm 450 terminal (Disdrlo mechanism). 

SOO DASI 300 or GSI terminal (Diablo mechanism). 

SOOS DASI 300S terminal (Diablo mechanism). 

uar Versatec D1200A printer>plotter. This version of plot phues a scan-converted image in 
f.usrftmpf raster tmd sends the result directly to the plotter device rather than to the 
standard output. The optional argument sends a previously scan-converted file called 
rsrfer to the plotter. 

FILES 

/usr/bin/tek 

/usr/bin/t450 

/nsr/bin/t300 

/usr/bin/tSOOs 

/usr/bin/vplot 

/usr/tmp/raster 

SEEALSO 

plet(3X), plot(5) 

BUGS 

There is no lockout protection for f usr/tmp/raster. 


o 
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NAME 

pmerge - pascal file merger 

SYNOPSIS 

pmerge name.p • • • 

DESCRIPTION 

Pmerge assembles the named Pascal files into a single standard Pascal program. The resulting 
program is listed on the standard output. It is intended to be used to merge a collection of 
separately compUed modules so that they can be run through pi, or exported to other sites. 

FILES 

/usr/tmp/MG* default temporary files 

SEE ALSO 

pc(l), pi(l), 

Auxiliary documentation Paeeal User *8 Manual in the Sun Fortran and Pares/Manual. 

BUGS 

Very minimal error checking is done, so incorrect programs will produce unpredictable results. 
Block comments should be placed after the keyword to which they refer or they are likely to end 
up in bizarre places. 



o 
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NAME 

pofitnews - submit news articles 

SYNOPSIS 

postnewn I article ] 

DESCRIPTION 

Fosinews calls up the inew8{l) utility to submit news articles to USENET. PMtnewr prompts you 
for the title of the article, for the newsgroup, and for the distribution. The title of the article 
should be a phrase suggesting the subject, so that persons reading the news can tell if they are 
interested in the article. 

If you omit the nams of the newsgroup (by typmg a carriage-return when asked for the news* 
group), poetnewf posts the article to gentral. 

general is read by everyone on the local machine. Other possible newsgroups include, but are not 
limited to, btl.genernlt read by all users at all Bell Labs sites on USENET, net.general, read by 
all users at all sites on USENET, and net. news, read by users interested in the network news on 
all sites. There is often a local set of newsgroups, such as ueb.all> that circulate within a local 
set of machines. In this case, ueb newsgroups circulate among machines at the University of Cali¬ 
fornia at Berkeley. 

The distributidli can be any valid list of newsgroup names, and defaults to the same as the news- 
group. If they are the same, the distribution is omitted from the headers put into the editor 
buffer. A distribution header is included in the headers of the article if given, affecting where the 
article is distributed to. 

After entering the title, newsgroup, and distribution, poetnewe calls up an editor program where 
you can compose the article. Poetnewe uses vt(l) as the editor unless you have specified another 
editor via the lEDITOR environment variable, in which case poetnewe uses the editor specified 
there. 

An initial set of hea<)ers containing the subject and newsgroups will be placed in the editor, fol¬ 
lowed by a blank line. The article should be appended to the bufiTer, after the blank line. These 
headers can be changed, or additional headers added, while in the editor, if desired. 

Optionally, the article is read from the file specified by article. 

For more sophisticated uses, such as posting news from a program, see inewe(l). 

SEE ALSO 

mail(l), checknews(l), inews(l), readnewB(l). 
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NAME 

pr - print file(s), possibly in multiple columns 

SYNOPSIS 

pr I -n ] ( +n J [ -h etring | | -wn ) ( -f) ( -In j ( -t) { -an ) ( -m [( 1 • • • 

DESCRIPTION 

Pr prepares one or more^es’s for printing. The output is separated into pages headed by a date, 
the name of the file or a specified header, and the page number. Pr prints its standard input if 
there are no file arguments. 

Inter-terminal messages via u;n7e(l) are forbidden during a pr. 

OPTIONS 

Options apply to all following file's but may be reset between file's: 

-n Produce n-column output. This option overrides the -t option (see below). 

+n Begin printing with page n. 

-h string 

Use string as a header for the page instead of the default header. 

-wn For purposes of multi-column output, take the width of the page to be n characters 
instead of the default 72. 

-f Use formfeeds instead of newlines to separate pages. A formfeed is assumed to use up 
two blank lines at the top of a page. Thus this option does not affect the effective page 
length. 

-In Take the length of the page to be n lines instead of the default 66. 

-t Do not print'the 5-line header or the 5-line trailer normally supplied for each page. 

Formfeed characters are not generated when this option is used, even if the -f option was 
used. The -t option is intended for applications where the results should be directed to a 
file for further processing. 

-8c Separate columns by the single character c instead of by the appropriate amount of white 
space. A missing c is taken to be a tab. 

-m Print all file's simultaneously, each in one column, 

EXAMPLES 

Print a file called dreadnaught on the printer — this is the simplest use of pr: 
krypton% pr dreadnaught | Ipr 
krypton% 

Produce three laminations of a file called ridings side by side in the output, with no headers or 
trailers, the results to appear in the file called Yorkshire: 

krypton% pr -m -t ridlngi ridings ridings > Yorkshire 
krypton% 

FILES 

/dev/tty? to suspend messages. 

SEE ALSO 

cat(l), Ipr(l) 

DIAGNOSTICS 

There are no diagnostics when pr is printing on a terminal. 

BUGS 

The options described above interact with each other in strange and as yet to be defined ways. 
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NAME 

printenv - print out the environment 

SYNOPSIS 

> priDtenv [ name j 

DESCRIPTION 

Frtntenv prints out the values of the variables in. the environment. If a name is specified, only its 
value is printed. 

If a name is specified and it is not defined in the environment, printenv returns exit status 1, else 
it returns status 0. 

SEE ALSO 

sh(l), environ(5), csh(l) 
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NAME 

prmail - print out waiting mail 

SYNOPSIS 

prmaJl ( user ... ] 

DESCRIPTION 

Prmail prints the mail which waits tor you, or the specified users. The mail is not disturbed. 

FILES 

/usr/spool/mail/* waiting mail files 
SEE ALSO 

biff(l), mail(l), from(l), binmail(l) 
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NAME 

prof - display profile data 
SYNOPSIS 

prof ( -a) I -1} ( -n ) ( -a 1 ( Hi ) ( -V ( -low | -high ) J ) [ a.out ( mon.out... |) 

DESCRIPTION 

Prof interprets the file produced by the monitor subroutine. Under default inodes, the aymbol 
table in the named object file (a.out by default) is read and correlated with the profile file 
(mon.out default). For each external symbol, the percentage of time spent executing between 
that symbol and the next is printed (in decreasing order), together with the number of times that 
routine was called and the number of milliseconds per call. If more than one profile file is 
specified, the output represents the sum of the profiles. 

To tally the number of calls to a routine, the program must be compiled with the —p option of 
CO, /77 or pe. This option also means that the profile file is produced automatically. 

OPTIONS 

-a Report all liymbols rather than Just external symbols. 

-1 Sort the output by symbol value. 

-n sort the output by number of calls. 

HI Produce a suinmary profile file in mon.oum. This is really only useful when more than 
one profile file is specified. 

-V Suppress all printing and produce a graphic version of the profile on the standard output 
for display by the plot(lG) filters. When plotting, the numbers low and high, (by default 
0 and 100), select a percentage of the profile to be plotted with accordingly higher resolu¬ 
tion. 

-I Print routines which have zero usage (as indicated by call counts and accumulated time). 

FILES 

mon.out for profile 
a.out for namelist 
mon.sum for summary profile 

SEE ALSO 

monitor(3), profil(2), cc(l), plot(lG), gprof(l) 

BUGS 

Rdware of quantization errors. 

Is confused by /77 which puts the entry points at the bottom of subroutines and functions. 
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NAME 

prs - print an SCCS file 
SYNOPSIS 

/unr/secn/prs | -d [ datagpee] ] j -r | S/Dj J | -« ] | -1 ) [ -a ) file ... 

DESCRIPTION 

Pr« prints, on the standard output, parts or all of an SCCS file (see 8ecafile(b)) in a user supplied 
format. If a directory is named, pr» behaves as though each file in the directory were specified as 
a named file, except that non-sccs files (last component of the path name does not begin with n.), 
and unreadable files are silently ignored. If a name of - is given, the standard input is read, in 
which case each line is taken to be the name of an SCCS file or directory to be processed; non- 
SCCS files and unreadable files are silently ignored. 

OPTIONS 

Options apply independently to each named file. 

-dj dslaspec] 

Specifies the output data specification. The dataapee is a string consisting of SCCS file 
data keyworda (see DATA KEYWORDS) interspersed with optional user supplied text. 

-T [ 5/Dl 

Specifies the 5CCS /Dentification (SID) string of a delta for which information is desired. 
If no SID is specified, the SID of the most recently created delta is assumed. 

-e Requests information for all deltas created earlier than and including the delta designated 
via the -r option. 

-1 Requests information for all deltas created later than and including the delta designated 
via the -r option. 

-a Requests printing of information for both removed, that is, delta type » R, (see 
rmdel{l)) and existing, that is, delta type — D, deltas. If the —a option is not specified, 
information for existing deltas only is provided. 

In the absence of the -d options, pra displays a default set of infomation consisting of: delta^type, 
release number and level number, date and time last changed, user-name of the person who 
changed the file, lines inserted, changed, and unchanged, the MR numbers, and the comments. 

DATA KEYWORDS 

Data keywords specify which parts of an SCCS file are to be retrieved and output. All parts of an 
SCCS file (see 8ees/Ue{5)) have an associated data keyword. There is no limit on the number of 
times a data keyword may appear in a dataapec. 

The information printed by pra consists of: I) the user supplied text; and 2) appropriate values 
(extracted from the SCCS file) substituted for the recognized data keywords in the order of 
appearance in the dataapec. The format of a data keyword value is either Simple (S), in which 
keyword substitution is direct, or Multi-line (M), in which keyword substitution is followed by a 
carriage return. 

User supplied text is any t^xt other than recognized data keywords. A tab is specified by \t and 
carriage return/new-line is specified by \n. 
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TABLE 1. sees Files Data Keywords 


Keymrd 

jDattt Item 

File Se cti on 

Value 

Format 

:Dt: 

Delt& information 

Delta Table 

See below* 

S 


Delta line statistics 

n 

d^U/iL d:/:Lu: 

s 

:Li: 

Lines inserted by Delta 

If 

nnnnn 

S 

:Ld: 

Lines deleted by Delta 

II 

nnnnn 

S 

:Lu: 

Lines unchanged by Delta 

» 

nnnnn 

s 

:DT; 

Delta type 

II 

D or R 

s 

:I: 

sees ID string (SID) 

» 

e*L Ss :S: 

s 

•Jt: 

Release number 

II 

nnnn 

s 

:L: 

Level number 

II 

nnnn 

s 

:B: 

Branch number 

w 

nnnn 

s 

:S: 

Sequence number 

If 

nnnn 

s 

:D: 

Date Delta created 

II 

d)y:/:Dm5/d)d: 

s 

:Dy: 

Year Delta created 

» 

nn 

s 

:Dm: 

Month Delta created 

n 

nn 

s 

:Dd: 

Day Delta created 

II 

nn 

s 

:T: 

Time Delta created 

11 

;Th;::Tm:;;Ts! 

s 

:Th: 

Hour Delta created 

n 

nn 

s 

:Tm: 

Minutes Delta created 

n 

nn 

s 

:Tb: 

Seconds Delta created 

II 

nn 

s 

:P: 

Programmer who created Delta 

II 

logname 

s 

;DS: 

Delta sequence number 

n 

nnnn 

s 

:DP: 

Predecessor Delta seq-no. 

n 

nnnn 

s 

:DI: 

Seq-no. of deltas incL, 
excl.^ ignored 

If 

iDn:/iDx:/{D$: 

s 

Dn: 

Deltas included (seq #) 

II 

:DS: iDSiaea 

s 

Dx: 

Deltas excluded (seq #) 

n 

d)S: d)S;... 

s 

Dg: 

Deltas ignored (seq #) 

w 

d)S: iDSlaaa 

s 

MR: 

MR numbers for delta 

II 

text 

M 

C: 

Comments for delta 

II 

text 

M 

UN: 

User names 

User Names 

text 

M 

FL: 

Flag list 

Flags 

text 

M 

Y; 

Module type flag 

II 

text 

s 

MF; 

MR validation flag 

n 

yes or no 

s 

MP; 

MR validation pgm name 

II 

text 

s 

KF: 

Keyword error/warning flag 

II 

ye# or no 

s 

BFi 

Branch fla^ 

II 

ye# or no 

s 

J: 

Joint edit flag 


ye# or no 

s 

LK: 

Locked releases 

II 

iRl.a. 

s 

Q: 

User defined keyword 

II 

text 

s 

M; 

Module name 

II 

text 

s 

FB: 

Floor boundary 

n 

:R: 

s 

OB: 

Ceiling boundary 

n 

iRx 

s 

Dk 

Default SID 

n 

d: 

s 

ND: 

Null delta flag 

If 

ye# or no 

s 

FD: 

File descriptive text 

Comments 

text 

M 

BDt 

Body 

Body 

text 

M 

OBi 

Gotten body 

11 

text 

M 

Wi 

A form of wAst(l) string 

N/A 

:Z::M:\t:I: 

s 


A form of wAat(l) string 

N/A 

;Z::Y: ;M: J::Z: 

s 


wAaf(l) string delimiter 

N/A 

0(#) 

s 


sees file name 

N/A 

text 

s 

PN: 

secs file path name 

N/A 

text 

s 


* d>t» = d)Ti tit tDt tTt tPt tDSi tDPt 
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EXAMPLES 

/uar/iees/pri —d’’Uteri and/or user IDs for tFt are:\niUNt” 
may produce on the standard output; 

Users and/or user IDs for s.file aret 

xyz 

131 

abc 

/usr/secs/prs -d” Newest delta for pgm sMn :Ii Created iDt By tPi” —r s^e 
may produce on the standard output: 

Newest delta for pgm main.ct 3.7 Created 77/12/1 By cas 
As a special ease: 

/usr/sees/prs s.flle 
may produce on the standard output: 



D 1.1 77/12/1 OOiOOjOO cas 1 000000/00000/00000 
MRsi 

bl78-12345 

bl79>54321 

COMMENTS! 

this is the comment line for s.file initial delta 

for each delta table entry of the “D” type. The only option argument allowed to be used with 
the special ease is the -a option. 


FILES 

/tmp/pr???7T 



SEE ALSO 

8CC8(1), admin(l). delta(l), get(l), help(l), 8ccsflle(5). 

Source Code Control System in Programming Tools for the Sun Workstation. 


DIAGNOSTICS 

Use help(l) for explanations. 


o 
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NAME 

ps - process status 

SYNOPSIS 

pa [ aeegklatuvwx# ] 

DESCRIPTION 

Pg displays information about processes. Normally, only processes that you have started are can* 
didates to be displayed by ps, but see the OPTIONS section below for how to get more informa¬ 
tion. Specifying a makes other users’ processes candidates to be displayed; specifying x includes 
processes without control terminals in the candidate pool. 

All output formats include, for each process, the process id PID, control terminal of the process 
TT, cpu time used by the process TIME (this includes both user and system time), the state 
STAT of the process, and an indication of the COMMAND which is running. 

The state is given by a sequence of four letters, for example, ‘RWNA’. 

First letter 

indicates the runnability of the process: 

R Runnable processes, 

T Stopped processes, 

P Processes in page wait, 

D Processes in disk (or other short term) waits, 

S Processes sleeping for less than about 20 seconds, 

I Processes which are idle (sleeping longer than about 20 seconds). 

Second tetter 

indicates whether a process is swapped out; 
blank 

(that is, a space) in this position indicates that the process is loaded (in memory). 

W Process is swapped out. 

> Process has specified a soft limit on memory requirements and has exceeded that 
limit shows; such a process is (necessarily) not swapped. 

Third tetter " 

indicates whether a process is running with altered CPU scheduling priority (nice): 
blank 

(that is, a space) in this position indicates that the process is running without spe¬ 
cial treatment. 

N The process priority is reduced, 

< The process priority has been raised artificiaOy. 

Fourth letter 

indicates any special treatment of the process for virtual memory replacement. The 
letters correspond to options to the vadvise{2) system call. Currently the possibilities 
are: 
blank 

(that is, a space) in this position stands for VA_NORM. 

A Stands for VA_ANOM. An A typically represents a program which is doing gar¬ 
bage collection. 

S Stands for VA.SEQL. An S is typicaf of large image processing programs which 
are using virtual memory to sequentially address voluminous data. 

OPTIONS 

a Display information about all processes with terminals (ordinarily only one’s own processes 
are displayed). 

e Display the command name, as stored internally in the system for purposes of accounting, 
rather than the command arguments, which are kept in the process’ address space. This is 
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more reliable, if less informative, since the process is free to destroy the latter information, 
e Display the environment as well as the arguments to the command. 

g Display all processes. Without this option, ps only prints ^interesting’ processes. Processes 
are deemed to be uninteresting if they are process group leaders. This normally eliminates 
top-level command interpreters and processes waiting for users to login on free terminals. 

k Use the file Ivmcott in place of /iev/Jfemcm and /dcv/mcm. This is used for postmortem 
system debugging. 

1 Display a long listing, with fields PPID, CP, PRI, NI, ADDR, SIZE, RSS and WCHAN as 
described below. 

I Adds the size SSIZ of the kernel stack of each process (for use by ^stem maintainers) to the 
basic output format. 

tx Restrict output to processes whose controlling tty is x (which should be specified as printed 
by p8j for example, iS for ttyS, tco for console, tdO for ttydO, t? for processes with no tty, 
etc). This option must be the last one given. 

u Display user-oriented output. This includes fields USER, %CPU, NICE, SIZE, and RSS as 
described below. 

V Display a version of the output containing virtual memory. This includes fields RE, SL, 
PAGEIN, SIZE, RSS, LIM, TSIZ, TRS, %CPU and %MEM, described below. 

w Use a wide output format (132 columns rather, than 80); if repeated, that is, ww, use arbi¬ 
trarily wide output. This information is used to decide how much of long commands to 
print. 

X Display even those processes with no terminal. 

# A process number may be given, (indicated here by #), in which case the output is res* 
tricted to that process. This option must also be last. 

A second argument tells p$ where to look for core if the k option is given, instead of /vmcore. A 
third argument is the name of a swap file to use instead of the default /dev/drum. If a fourth 
argument is given, it is taken to be the file containing the system’s namelist. Otherwise, /vmunix 
is used; 

DISPLAY FORMATS 

Fields which are not common to all output formats: 

USER name of the owner of the process 

%CPU cpu utilization of the process; this is a decaying average over up to a minute of previ¬ 
ous (real) time. Since the time base over which this is computed varies (since 
processes may be very young) it is possible for the sum of all %CPU fields to exceed 
100 %. 

NICE (or NI) process scheduling increment (see set priority {2) and mce(3C). 

SIZE virtual size of the process (in 1024 byte units) 

RSS real memory (resident set) size of the process (in 1024 byte units) 

LIM soft limit on memory used, specified via a call to g€trlimit{2); if no limit has been 

specified then shown as xx 
TSIZ size of text (shared program) image 
TRS size of resident (real memory) set of text 
%MEM percentage of real memory used by this process. 

RE residency time of the process (seconds in core) 

SL sleep time of the process (seconds blocked) 

PAGEIN number of disk i/o’s resulting from references by the process to pages not loaded in 
core. 

UID numerical user-id of process owner 

PPID numerical id of parent of process 
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CP short-term cpa utilization factor (used in scheduling) 

PRI process priority (non-positive when in non-interruptible wait) 

ADDR sw^ address of the process 

WCHAN event on which process is waiting (an address in the system), with the initial part of 
the address trimmed off, for example, 80004000 prints as 4000. 

F flags associated with process as in <$y$/proe.h>: 

SLOAD 0000001 in core 

SSYS 0000002 swapper or pager process 

SLOCK 0000004 process being sw>q>ped out 

SSWAP 0000008 save area flag 

STRC 0000010 process is being traced 

SWTED 0000020 another tracing flag 

SULOCK 0000040 user settable lock in core 

SPACE 0000080 process in page wait state 

SKEEP 0000100 another flag to prevent swap out 

SOMASK 0000200 restore old mask after taking signal 
SWEXIT 0000400 working on exiting 

SPHYSIO 0000800 doing physical i/o (bio..c) 

SVFORK 0001000 process resulted from vfork() 

SVFDONE 0002000 another vfork flag 

SNOVM 0004000 no vm, parent in a vfork() 

SPAGI 0008000 init data space on demand, from inode 
# 

SSEQL 0010000 user warned of sequential vm behavior 
SUANOM 0020000 user warned ot anomalous vm behavior 
STIMO 0040000 timing out during sleep 

SOUSIG 0100000 using old signal mechanism 

SOWEUPC 0200000 owe process an addupc() call at next ast 
SSEL 0400000 selecting; wakeup/waiting danger 

SLOGIN 0800000 a login process (legit child of init) 

SPTECHQ 1000000 pte’s for process have changed 

A process that has exited and has a parent, but has not yet been waited for by the parent is 
marked <defuttet>; a process which is blocked trying to exit is marked <exiting>: ps makes an 
educated guess as to the flie name and arguments given when the process was created by examin¬ 
ing memory or tlie swap area. The method is inherently somewhat unreliable and in wy event a 
prppess is entitle<i to destroy this information, so the names cannot be counted on too much. 

FILES 

/vmunix system namelist 
/dev/kmem kernel memory 
/dev/drum swap device 
/vmeore core file 

/dev searched to find sw^ device and tty names 

SEE ALSO 

kUl(l), w(l) 

BUGS 

Things can change while ps is running; the picture it gives is only a close approximation to real¬ 
ity. 
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NAME 

pti - phototypesetter interpreter 



SYNOPSIS 

ptl [ file ... ] 

DESCRIPTION 

Pti shows the commands in a stream from the standard output of troS{l) using troff'a —t option, 
interpretug them as they would act on the typesetter. Horizontal motions shows as counts in 
internal units and are marked with '<’ and *>’ indicating left and right motion. Vertical space 
is called leading and is also indicated. 

The output is really cryptic unless you are an experienced C/A/T hardware person. It is better 
to use troff -a. 

SEE ALSO 

troff(l) 


t 

6 

I 
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NAME 

ptx - permuted index 
SYNOPSIS 

ptx ( -f 1 (-t 1 (-w n 1 [ -g rt 1 I -o only J ( -1 ignore ] ( -b break J ( -r j [ input ( output J j 
DESCRIPTION 

Ptx generates a permuted index of the contents of file input onto file output (defaults are standard 
input and output). Ptx has three phases: the first does the permutation, generating one line for 
each keyword in an input line. The keyword is rotated to the front. The permuted file is then 
sorted. Finally, the sorted lines are rotated so the keyword comes at the middle of the page. Ptx 
produces output in the form: 

.XX "tail” "before keyword” "keyword and after" "head” 

where .xx may be an nroJB{l) or troS{l) macro for user-defined formatting. The before keyword 
and keyword and after fields incorporate as much of the line as will fit around the keyword when 
it is printed at the middle of the page. Tail and head, at least one of which is an empty string 
are wrapped-around pieces small enough to fit in the unused space at the opposite end of the line. 
When original text must be discarded, marks the spot. 

OPTIONS 

-t Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter; the default line length is 100 characters. 

-wn Use the next argument, n, as the width of the output line. The default line length is 72 

characters. 

-gn Use the next argument, n, as the number of characters to allow for each gap among the 
four parts of the line as finally printed. The default gap is 3 characters. 

-oonly Use as keywords only the words given in the only file. 

-lignore 

Do not use as keywords any words given in the ignore file. If the -I and -o options are 
missing, use /uorfHbfeign as the ignore file. 

-hbreak 

Use the characters in the break file to separate words. In any case, tab, newline, and 
space characters are always used as break characters. 

-r Take any leading nonblank characters of each input line to be a reference identifier (as to 
a page or chapter) separate from the text of the line. Attach that identifier as a 5th field 
on each output line. 

FILES 


BlloS 


/b|p/sort 

/usr/lib/eign 


Line length counts do hot account for overstriking or proportional spacing. 
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NAME 

pwd - print working directory name 


SYNOPSIS 

pwd 



DESCRIPTION 

Pwd prints the pathname of the working (current) directory. 

If you are using e«A(l), you can use the dir$ builtin command to do the same job more quickly; 
BUT dire can give a different answer in the rare case that the current directory or a containing 
directory was moved after the shell descended into it. This is because pwd searches back up the 
directory tree to report the true pathname, whereas dirt remembers the pathname from the last 
cd command. The example below illustrates the differences. 

% ed /usr/wendy/January/reports 
% pwd 

/usr/wendy/january/reports 
% dlrs 

~/january/reports 

% mv ^/January "/february 
% pwd 

/usr/wendy/february /reports 
% dlrs 

"/January/reports 

% 


Pwd and dirt also give different answers when you change directory through a symbolic link. For 
example: 


% cd /usr/wendy/January/reports 
% pwd 

/usr/wendy/January/reports 

% dlrs 

"/January/reports 
% Is -1 /usr/wendy/January 
Irwxrwxrwx 1 wendy 17 Jan 30 

% cd /usr/wendy/January 
% pwd 

/usr/wendy/1984/Jan 
% dlrs 

/usr/wendy/January 



1 

I 

I 

» 

I 


1983 /usr/weDdy /January -> /usr/wendy/l984/jan/ 


SEE ALSO 

cd(l), csh(l), getwd(3) 


[ 
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NAME 

px - Pascal interpreter 
SYNOPSIS 

px I obj { argument... ] ] 

DESCRIPTION 

Px interprets the abstract machine code generated by pi. The first argument is the file to be inter¬ 
preted, and defaults to oi/; remaining arguments are available to the Pascal program using the 
built-ins srgv and urge. Pais also invoked by pta when running ‘load and go’. 

If the program terminates abnormally an error message and a control fiow backtrace are printed. 
The number of st^ements executed and total execution time are printed after normal termina¬ 
tion. The p option of pi suppresses all of this except the message indicating the cause of abnor^ 
mal termination. 

FILES 

obj default object file 

pmon.out profile data file 

SEE ALSO 

The Pascal Uter’x Manual in the Sun Fortran and Pascal Manual. 
pi(l), pix(l) 

DIAGNOSTICS 

Most run-time error messages are self-explanatory. Some of the more unusual ones are: 

Reference to an inactive file 

A file other than input or output was used before a call to rcsel or rewrite. 

Statement count limit exceeded 

The limit of 500,000 executed statements (which prevents excessive looping or recursion) 
has been exceeded. 

Bad data found on integer read 
B%d data found on real read 

Usually, non-numeric input was found for a number. For reals, Pascal requires digits 
before and after the decimal point so that numbers like *.1’ or ‘21.’ evoke the second diag- 
bostiei 

panic: Some meooage 

Indicates a internal inconsistency detected in px probably due to a Pascal system bug. 

BUGS 

Post-mortem traceback is not limited; infinite recursion leads to almost infinite traceback. 
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NAME 

pxp “ Pascal execution profiler 
SYNOPSIS 

pxp ( -acdeljnstuw.,) ( -23450780 ) ( -» ( name ... ] ) name.p 
DESCRIPTION 

Pxp can be used to obtain execution profiles of Pascal programs or as a pretty-printer. To pro¬ 
duce an execution profile all that is necessary is to translate the program specifying the s option 
to pi or piXy execute the program, and then type the command 
tutoriaI% pxp -a nanie.p 

Pxp generates a reformatted listing if none of the c, t, or s options are specified; thus 
tutorial^ pxp old.p > new.p 

places a. pretty-printed version of the program in old.p in the file new.p, 

OPTIONS 

The use of the following options of pxp is discussed in the Pascal User^s Manual in the Sun For¬ 
tran and Pasca/Manual. 

-a Print the bodies of all procedures and functions in the profile; even those which were never 
executed. 

-e Extract profile data from the file core. 

-d Include declaration parts in a profile. 

-e Eliminate Include directives when reformatting a file; the Include is replaced by the refor¬ 
matted contents of the specified file. 

-f Fully parenthesize expressions. 

-J Left justify all procedures and functions. 

-n Eject a new page as each file is included; in profiles, print a blank line at the top of the 
page. 

-t Strip comments from the input text. 

-t Print a table summarizing procedure and function call counts. 

-u Card image mode; only the first 72 characters of input lines are used. 

-w Suppress warning diagnostics. 

—a Generate an execution profile. If no names are given the profile is of the entire program. If 
a list of names is given, then only any specified procedures or ftinctions and the contents 
of any specified include files will appear in the profile. 

—_ Underline keywords. 

-d use d spaces (where d is a digit, 2 < d < 9) as the basic indenting unit. The default is 4. 

FILES 

name.p input file 

name.i include file(s) 

pmon.out profile data 

core profile data source with -c 

/usr/lib/how_pxp information on basic usage 
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i 


SEE ALSO 

The Pa»cal V»er '» Manual in the Sun Fortran and Paaeal Manual. 
pi(l), px(t) 

DIAONOSTIGS 

For a hasie explanation do 

pxp 

Error diagnostics include ‘No profile data in file’ with the e option if the a option was not enabled 
to pi; ‘Not a Pascal system core file’ if the core is not from a px execution; ‘Program and count 
data do not correspond’ if the program was changed after compilation, before profiling; or if the 
wrong program is specified. 

BUGS 

Does not place multiple statements per line. 


o 
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NAME 

pxref - Pascal cross-reference program 

SYNOPSIS 

pxref [ - ] name 



DESCRIPTION 

Pxref makes a line numbered listing and a cross-reference of identifier usage for the program in 
name. The optional argument suppresses the listing. The keywords goto and label are 
treated as identifiers for the purpose of the cross-reference. Include directives are not processed, 
but cause the placement of an entiy indexed by *#include’ in the cross-reference. 

SEE ALSp 

Tjl^e Pascal User*s Manual in the Sun Fortran and Pascal Manual. 

BUGS 

Identifiers are trimmed to 10 characters. 
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NAME 

ranlib - convert archives to random libraries 

SYNOPSIS 

ranlib uchive... 

DESCRIPTION 

Ranlib converts each archive to a form which the loader can load more rapidly. Ranlib does this 
by adding a table of contents called _.SYMDBP to the beginning of the archive. Ranlib uses 
ar(l) to reconstruct the archive, so that sufficient temporary file space must be available in the 
file system which contains the current directory. 

SEE ALSO 

ld(l), ar(l), lorder(l) 

BUGS 

Because generation of a library by ar and randomization of the libraiy by ranlib are separate 
processes, phase errors are possible. The loader. Id, warns when the modification date of a library 
is more recent than the creation date of its dictionary; but this means that you get the warning 
even if you only copy the library. 
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NAME 

ratfor - rational Fortran dialect 
SYNOPSIS 

ratfor | -0 c | | -C ) ( -h ) 1 filename ... ] 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides 
control flow constructs essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement } 

declsIon-msJtlng: 

if (condition) statement { else statement ] 
switch (integer value) { 

case integer: statement 

(default: | statement 

} 

loops: while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement ( until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 

free form Input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment 

translation of relatlonals: 

>, >*, etc., become .GT., .GE., etc. 

return(expres8ion) 

returns expression to caller from function 
define: define name replacement 

Include: 

include filename 

Ratfor is best use<i with /77(1). 

OPTIONS 
-dc 

-c 

-h 

SEE ALSO 

f77(l) 

B. W. 


Use the character c as the continuation character in column 0 when translating to For* 
tran. The default is to use the St character as a continuation character. 

Pass Ratfor comments through to the translated code. 

Translate Ratfor string constants to Hollerith constants of the form nnnh string, Other* 
wise just pass the strings through to the translated code. 

Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 

rep - remote file copy 

SYNOPSIS 

rep filel file2 

rep I -r ] file ... directory 

DESCRIPTION 

Rep copies files between machines. Each file or direetory argument is either a remote file name of 
the form “rho8t:path”, or a local file name (containing no characters, or a before any ‘:’s.) 

If the -r is specified and any of the source files are directories, rep copies each subtree rooted at 
that name; in this case the destination must be a directory. 

If path is not a full path name, it is interpreted relative to your login directory on rkoet. A path 
on a remote host may be quoted (using \, *, or ^ so that the metacharacters are interpreted 
remotely. 

Rep does not prompt for passwords; your current local user name must exist on rkoat and allow 
remote command execution via rsh(lC). 

Rep handles third party copies, where neither source nor target files are on the current machine. 
Hostnames may also take the form “rhost.mame" to use rname rather than the current user name 
on the remote host. 

Please note; rep is meant to copy from one host to another; if by some chance you try to copy a 
file on top of itself, you will end up with a severely corrupted file (for example, if you executed 
the following command from host george: ‘george% rep testfile george:/u8r/me/testfile’). 
Remember where you are at all times (putting your hostname in your prompt helps with this)! 

SEE ALSO 

ftp(lC), rsh(lC), rlogin(lC) 

BUGS 

t)oe8n’t detect all cases where the target of a copy might be a file in cases where only a directory 
should be legal. 

Is confused by any output generated by commands in a .login, .profile, or .eshre file on the remote 
host. 

Rep doesn’t copy ownership, mode, and timestamps to the new files. 
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NAME 

readnews - read news articles 
SYNOPSIS 

resMlnewB ( -a date | [ -n newsgroups j ( -t titles ) [ -IprxhftiM 1 (-c [ mailer ) ] 
readnewt -a 
DESCRIPTION 

Readnews without argument displays unread articles, 
readnews displays the newsgroup subscription list. 

Readnews maintains a .newsrc file in your home directory that specifies all news articles already 
read, .newsrc is updated at the end of each news reading session in which the -x or -1 options 
weren't specified. If the NEWSRC environment variable is present, it should be the path name of 
a file to be used in place of .newsrc. 

An options line may be placed in the .newsrc file. The options line starts with the word options 
(left justified) followed by the list of standard options Just as they would be typed on the read- 
news command line. The list of options may include: the -n flag along with a newsgroup list; a 
favorite interface to use for reading the news; and/or the -r or -t flag. Continuation lines are 
specified by following lines beginning with a space or tab character. Similarly, options can be 
specified in the NBWSOPTS environment parameter. Options on tlie command line override 
options in the .newsrc file and options in the .newsre file override options in the NEWSOPTS 
environment parameter. 

When you use the reply command of the mail{l) or lbinlmail{l) interfaces, readnews uses the 
MAILER environment parameter to determine which mailer to use. The default is usually mail. 

You can specify a particular paging program for paging through articles. The PAGER environ¬ 
ment parameter should be set to the name of the paging program. The name of the article is 
referenced with a *%\ as in the -c option. If no *%' is present, the article is piped to the pro¬ 
gram. Paging may be disabled by setting PAGER to a null value. 

OPTIONS 

Some of the option flags determine which of the several interfaces you can use for reading your 
news. The news qrstem has its own interface which is used if no other choice is made, otherwise 
one of these options can be used: 

-M An interface to mat7(l). 

-c A f bin/mail{i)-like interface. 

-c 'maiYcP 

All selected articles written to a temporary file. Then the mailer is invoked. The name 
of the temporary file is referenced with a Thus, ‘mail -f will invoke mail on a 
temporary file consisting of all selected messages. 

Other options govern the behavior of readnews itself, as follows: 

~p Send all selected articles to the standard output with no questions asked. 

-1 Display only the titles. Do not update the .newsre file. 

—r display the articles in reverse order. 

-f Do not display any followup article 

—h Display articles in a less verbose format (intended for terminals running at 300 baud). 

-u Update the file every 5 minutes, in case of an unreliable system. Note that if the 

. .newsre file is updated, the x command will not restore it to its original contents. 
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The following flags determine the selection of articles; 

•n newsgroups 

Select all articles that belong to newsgroups. 

—t titles 

Select all articles whose titles contain one of the strings specified by titles. 

-a I dale] 

Select all articles that were posted past the given date (in getdate(Z) format). 

-X Ignore mnewsre file. That is, select articles that have already been read as well as new 
ones. 

COMMANDS 

This section lists the commands you can type to the readnews and fbinfmail interface prompts. 
The readnews interface suggests some common commands in brackets. Just typing carriage- 
return is the same as typing the first command. For example, '(ynq]’ means that the commands 
*y’ (yes), ‘n’ (no), and 'q' (quit) are common responses, and that *y* is the default. Here are the 
commands and their meanings; 

y Yes — displays current article and goes on to next. 

n No — goes on to next article without displaying current one. In the /binfmail interface, 
this means ^go on to the next article', which has the same effect as 'y' or just typing 
carriage-return. 

q Quit — the .newsrc file is updated if -1 or -x were not on the command line, 

c Cancel the article — only the author or the super user can do this. 

r Reply — reply to article's author via mail. Readnews calls up your EDITOR with a 
header specifying To, Subject, and References lines taken from the message. You may 
change or add headers, as appropriate. You add the text of the reply after the blank line, 
and then exit the editor. The resulting message is mailed to the author of the article. 

rd Reply directly — readnews calls up the mail program (or the program specified in the 
tMAILER environment variable) so that you can reply to the author. Type the text of 
the reply and then control-D. 

f \titl^ Submit a follw up article. Normally you should leave off the title, since the system gen¬ 
erates one for you. Readnews calls up your EDITOR so that you can compose the text of 
the followup. 

fd Followup directly, without edited headers. This is like /, but the headers of the article 
are not included in the editor buffer. 

N [newsgroup] 

Go to the next newsgroup or named newsgroup. 

8 [^e] Save ^ ihe article is appended to the named file. The default filename is Articles. If the 
first character of the filename is '|', the rest of the filename is taken as the name of a pro¬ 
gram, which is executed with the text of the article as standard input. If the first charac¬ 
ter of the filename is */\ it is taken as a full path name of a file. If the INEWSBOX 
environment variable is set to a full path name, and the filename contains no the file 
is saved in tNEWSBpX, otherwise, it is saved relative to IHOME. 

# Report tile name and size of the newsgroup, 
e Erase — forget that this article was read, 
h . Print a more vertiose header. 

H Print a very verbose header, containing all known information about the article. 

U Unsubscribe from this newsgroup. Also goes on to the next newsgroup. 
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d Read a digest. Breaks up a digest into separate articles so you can read and reply to 
each piece. 

D Decrypt — invokes a Caesar decoding program on the body of the message. This is used 
to decrypt rotated jokes posted to net.jokes. Such jokes are usually obscene or otherwise 
offensive to some groups of people, and so are rotated to avoid accidental decryption by 
people who would be offended. The title of the joke should indicate the nature of the 
problem, enabling people to decide whether to decrypt it or not. 

Normally the Caesar program does a character frequency count on each line of the article 
separately, so that lines which are not rotated will be shown in plain text. This works 
well unless the line is short, in which case it sometimes gets the wrong rotation. An 
explicit number rotation (usually 13) may be given to force a particular shift. 

V Print the current version of the news software. 

! Shell escape. 

number Go to number. 

[n] Skip n articles. The articles skipped are recorded as *unread’ and will be offered to you 
again the next time you read news. 

Go back to last article. This is a toggle, typing it twice returns you to the original arti¬ 
cle. 

X Exit — like quit except that .newerc is not updated. 

X system 

Transmit article to the named system. 

The c, f, fd, r, rd, e, h, H, and s commands can be followed by -’s to refer to the previous article. 
Thus, when replying to an article using the readnews interface, you should normaJly type *r~' (or 
*re-’) since by the time you enter a command, you are being offered the next article. 

EXAMPLES 

readnews 

Read all unread articles using the readnews[l) interface. The •neu;src file is updated at 
the end of the session. 

readnews -c ed % -1 

Use the ed(l) text editor on a file containing the titles of all unread articles. The .newsre 
file is not updated at the end of the session. 

readnews -id all !fa.all -M -r 

Read all unread articles except articles whose newsgroups begin with IB fa . via mai7(l) 
in reverse order. The .newsrc file is updated at the end of the session. 

readnews -p -n ail -a last thursday 

Print every unread article since last Thursday. The .newsre file is updated at the end of 
the session! 

readnews -p > /dev/null & 

Discard all unread news. This is useful after returning from a long trip. 

FILES 

fuBTIspoollnew^f newsgroupf number News articles 

/usr/lib/news/active Active newsgroups and numbers of articles 

/usr/lib/news/help Help file for readnews{l) interface 

"^/.newsrc Options and list of previously read articles 

SEE ALSO 

checknews(l), inews(l), sendnews(8), recnews(8), uurec(8), mail(l), news(5), newsrc(5) 
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NAME 

recnews - receive unprocessed articles via mail 
SYNOPSIS 

/usr/lib/newn/reenews ( newsgroup [ sender ] ] 

DESCRIPTION 

Ueenews reads a letter from the standard input; determines the article title, sender, and news- 
group; and gives the body to inews with the right arguments for insertion. 

If newsgroup is omitted, the to line of the letter is used. If sender is omitted, the sender is deter¬ 
mined from the from line of the letter. The title is determined from the subject line. 

SEE ALSO 

inews(l), uurec(8), sendnewB(8), readnews(l), chechnews(l) 
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NAME 

refer - find and insert literature references in documents 

SYNOPSIS 

refer ( -ar) 1 -b) ( -c»tring | ( -e j | -k*) | ) | -p /We} | -n ) (-nkeyd J file ... 

DESCRIPTION 

Refer is a preprocessor for nroffiX), or that finds and formats references. The input files 

(standard input by default) are copied to the standard output, except for lines between .[ and .] 
command lines. Such lines are assumed to contain keywords as for lookbib{l), and are replaced by 
information from a bibliographic data base. The user can avoid the search, override fields from 
it, or add new fields. The reference data, from whatever source, is assigned to a set of troff 
strings. Macro packages such as m«(7) print the finished reference text from these strings. A fiag 
is placed in the text at the point of reference. By default, the references are indicated by 
numbers. 

When refer is used with e 9 n(l), ne 9 n(l), or Ibl(l), refer should be used first in the sequence, to 
minimize the volume of data passed through pipes. 

OPTIONS 

-nr Reverse the first r author names (Jones, J. A. instead of J. A. Jones). If r is omitted, all 
author names are reversed. 

-b Bare mode — do not put any flags in text (neither numbers or labels). 

-cetring 

Capitalize (with SMALL CAPS) the fields whose key>letters are in tiring. 

-e Accumulate references instead of leaving the references where encountered, until a 
sequence of the form: 

•1 

$LIST$ 

■1 

is encountered, and then write out all references collected so far. Collapse references to 
the same source. 

»k:r Instead of numbering references, use labeb as specified in a reference data line beginning 
with the characters %x; By default, x is L. 

-Im,n Instead of numbering references, use labels from the senior author’s last name and the 
year of piiblication. Only the first m letters of the last name and the last n digits of the 
date are used. If either of m or n is omitted, the entire name or date, respectively, is 
used. 

-p Take the next argument as a file of references to be searched. The default file is searched 
last. 

-n Do not search the default file. 

skeys Sort refefence^ by fields whose key-letters are in the key9 string, and permute reference 
numbers in the text accordingly. Using this option implies the option. The key- 
letters in keys may be followed by a number indicating how many such fields are used, 
with a + sign taken as a very large number. The default is AD, which sorts on the 
senior author and date. To sort on all authors and then the date, for instance, use the 
options -«A+T. 

FILES 

/usr/dict/papers directory of default publication lists and indexes 

/usr/lib/refer directory of programs 
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NAME 

reset - reset the teletype bits to a sensible state 

SYNOPSIS 

reset 

DESCRIPTION 

Retet sets the terminal to cooked mode, turns off cbreak and raw modes, turns on nl, and restores 
special chaiacteFS that are undeSned to their default values. 

This is most useful after a program dies leaving a terminal in a funny state; you have to type 
“<LF>re8et<LF>’* to get it to work then to the shell, za <CR> often doesn’t work; often 
none of this will echo. 

It’s a good idea to follow reset with tsel(l) 

SEE ALSO 

stty(l), t8et(l) 

BUGS 

Doesn’t set tabs properly; it can’t intuit personal choices for interrupt and line kUI characters, so 
it leaves these the standard settings which are *H (backspace) for erase character, "U for line kill 
character, and ‘C for interrupt character. 

It could well be argued that the shell should be responsible for ensuring that the terminal remains 
in a sane state; this would eliminate the need for this program. 



o 


o 
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NAME 

rev - reverse lines of a file 

SYNOPSIS 

rev I file ] ... 

DESCRIPTION 

Rev copies the nanned files to the standard output, reversing the order of characters in every line. 
If no file is specified, the standard input is copied. 
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NAME 

rlogin - remote login 
SYNOPSIS 

rloglii rAoel I-ee I ( -1 ueernamt] (-8 ) 
rAo»< (-ec l (-1 urernamc ] ( -S j 

DESCRIPTION 

Rlogin connects your terminal on the current local host system Ihoot to the remote host ^stem 
rhoit. 

Each host has a file /ele/ftosis.efutv which contains a list of rkost'a with which it shares account 
names. (The host names must be the standard names as described in r«A(lC).) When you rlogin 
as the same user on an equivalent host, you don’t need to give a password. Each user may ako 
have a private equivalence list in a file .rhoott in his login directory. Each line in this file should 
contain an rhott and a uoername separated by a space, giving additional cases where logins 
without passwords are to be permitted. If the originating user and host is not found in these files, 
the remote machine will prompt for a password as in login{l). To avoid some security problems, 
the .rkotfo tilt must be owned by either the remote user or root and may not be a symbolic link. 

Your remote terminad type is the same as your local terminal type (as given in your environment 
TERM variable). All echoing takes place at the remote site, so that (except for delays) the rlogin 
is transparent. Flow control via and ‘Q and Bushing of input and output on interrupts are 
handled properly. 

ESCAPES 

Lines starting with the tilde character are 'escape sequences’ (the escape character can be changed 
via the -e options): 

Disconnect from the remote host — this is not the same as a logout, because the local 
host breaks t||« connection with no warning to the remote end. 

'"'Z Suspend the ll>gin session (only if you are using the C-Shell). Suop is your ‘suspend’ char> 
acter — usually controbZ — see 

' ‘ Y Suspend the input half of the login, but output will still be seen (only if you are using the 
C-Shell). Doiup is your 'deferred suspend’ character — usually controb-Y — see 

OPTIONS 

-1 Specifies a different user name {uoername, in the synopsis) for the remote login. If you do 
not use this option, the remote username used is the same as your local username. 

-• Specifies a different escape character (e, in the synopsis) for the line used to disconnect from 
the remote host. 


^ -8 Pass eight>bit data across the net instead of seven-bit data. 

SEE ALSO 

reh(lC), stty(l) 


FILES 

/usr/hosts/* 

/etc/bosts 

/etc/hosts.equiv 

~/.rhosts 

/etc/services 


for rkoot version of the command 
to translate hostname to network address 
list of rkoot 0 with shared account names 
private list of rkooto with shared account names 
- to translate service name tcp/rlogin to network port number 


BUGS 

This implementation can only use the TCP network service. 


More terminal characteristics should be propagated. 
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NAME 

rm, rmdir - remove (unlink) files or directories 
SYNOPSIS 

rm I -f I I 1 ( -i) 1 - 1 file . •. 

rmdir dir • • • 

DESCRIPTION 

Rm removes the directory entries for one or more files. If an entry was the last link to the file, 
the file is destroyed. Rm^r and rmdir remove entries for directories. 

To remove a file, you must have write permission in its directory; but you don’t need read or 
write permission on the file itself. If you don’t have write permission on the file and the standard 
input is a terminal, rm displays the file’s permissions and waits for you to type in a response. If 
your response begins with ‘y* the file is deleted; otherwise the file is left alone. 

To remove a full directory, use rm with the —r option (see below). Rmdir removes the named 
directory only if it is empty. 

OPTIONS 

The following are options for rm: 

-*f Force files to be removed, without displaying permissions, asking questions, or reporting 
errors. 

-r Recursively delete the entire contents of the specified directory and the directory itself. 

-I Ask whether to delete each file, or, under -r, whether to examine each directory. Some¬ 
times called the Interactive option. 

- Treat ail the following arguments as filenames — so that you can specify filenames start¬ 
ing with a minus. 

WARNING 

It is forbidden to remove the file merely to avoid the antisocial consequences of inadvertently 
doing something like ’rm -r 

SEE ALSO 

rmdir(l), rmdir(2), unlink(2) 
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Ni^E 

rmdel - remove a delta from an SCCS file 
SYNOPSIS 

/uar/sees/rmdel—rSID file ... 

DESOmPTION 

Rmdel removes the delta specified by the SID from each nmned SCCS file. The delta to be 
removed must be the newest (most recent) delta in its branch in the delta chain of each named 
SCCS file. In addition, the SID specified must not be that of a version being edited for the pur¬ 
pose of making a delta (that is, if a p-file (see tfcf(l)) exists for the named SCCS file, the SID 
specified must not appear in any entry of the p-file). 

If a directory is named, rmdel behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path name does not begin with a.) 
and unreadable files are silently ignored. If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be processed; non-SCCS files 
and unreadable files are silently ignored. 

The exact permissions necessary to remove a delta are documented in the Source Code Control 
System User’s Guide. Simply stated, they are either 1) if you make a delta you can remove it; or 
2) if you own the file and directory you can remove a delta. 

FILES 

X'file (see delta{l)) 

z-file (see (fc/lfl(l)) 

SEE ALSO 

8ccs(l), delta(l), get(l), help(l), prs(l), sccsfile(5). 

Source Code Control System in Programming Tools for the Sun Workstation. 

DIAGNOSTICS 

Use Ac/p(l) for explanations. 
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NAME 

rindir, rm - remove (unlink) directories or files 

SYNOPSIS 

rmdir dir ... 

rml-fl|-i>I(-II(-lfiIe... 

DESCRIPTION 

Rmdtr removes entries for the named directories, which must be empty. 


Rm removes the entries for one or more files from a directory. If an entry was the last link to the 
file, the file u destroyed. Removal of a file requires write permission in its directory, but neither 
read nor write permission on the file itself. 

If a file has no write permission and the standard input is a terminal, its permissions are printed 
and a line is read from the standard input. If that line begins with ‘y’ the file is deleted, other¬ 
wise the file remains. No questions are asked and no errors are reported when the -f (force) 
option is given. 


If a designated file is a directory, an error comment is printed unless the optional argument -r 
has been used. In that case, rm recursively deletes the entire contents of the specified directory, 
and the directory, itself. 

If the -1 (interactive) optioh ,is in effect, rm asks whether to delete each file, and, under -r, 
whether to examine each directory. 

The null option - iliiiicates that all the arguments following it are to be treated as file names. 
This allows the specification of file names starting with a minus. 

SEE ALSO 

rm(l), unlink(2), rmdir(2) 
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NAME 

roflbib - run off bibliographic database 
SYNOPSIS 

roffblb ( -« -^h -n -o -r -n—Tterm -x -m mac -V -Q | ( file ... j 
DESCRIPTION 

Rojffbih prints out all records in a bibliographic database, in bibliography format rather th^ as 
footnotes or endnotes. Generally it is used in conjunction y/ith aortbib: 

sortbib database ( roffbib 

Rojfbib accepts most of the options understood by nroff{l), most importantly the -T flag to 
specify terminal type. 

If abstracts or comments are entered following the %X field key, roffbib will format them into 
paragraphs for an annotated bibliography. Several %X fields may be given if several annotation 
paragraphs a^e desired. The -x flag will suppress the printing of these abstracts. 

A user-defined set of macros may be specified after the -m option. There should be a space 
between the -m and the macro filename. This set of macros will replace the ones defined in 
/usr/lib/tmac/tmac.bib. The -V fiag will send output to the Versatec; the -Q flag will queue 
output for the phototypesetter. 

Four command-line registers control formatting style of the bibliography, much like the number 
registers of m»(7). The command-line argument -rNl will number the references starting at 1. 
The flag -rV2 will double space the bibliography, while -rVl will double space references but sin¬ 
gle space annotation paragraphs. The line length can be changed from the default 6.5 inches to 6 
inches with the -rL6i argument, and the page offset can be set from the default of 0 to one inch 
by specifying -rOli (capital O, not zero). Note: with the -V and -Q flags the default page offset 
is already one inch. 

FILES 

/usr/lib/tmac/tmac.bib file of macros used by nroffjtroff 
SEE ALSO 

refer(l), addbib(l), sortbib(l), indxbib(l), lookbib(l) 

BUGS 

Users have to rewrite macros to create customized formats. 
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NAME 

rsh - remote shell 
SYNOPSIS 

reh host [ -1 username ] | -n ] command 
host [ -I username ] ( -n ] command 

DESCRIPTION 

Rdh connects to the specified host, and executes the specified command. Reh copies its standard 
input to the remote command, the standard output of the remote command to its standard out¬ 
put, and the standard error of the remote command to its standard error. Interrupt, quit and ter¬ 
minate signals are propagated to the remote command; reh normally terminates when the remote 
command does. 

If you omit command, instead of executing a single command, roli logs you in on the remote host 
using rloffin(lC). 

Shell metacharacters which are not quoted are interpreted on the local machine, while quoted 
metacharacters are interpreted on the remote machine. Thus the command: 

tutorial% rsh Usard eat lisard.flle > > tutorlaLflle 
appends the remote file lizard.file from the machine called lizard to the file called tutoriaifile on 
the machine called tutorial, while the command: 

tutorial^ rsh iisard eat lisard.flle ’*>>” another.Dsard-file 
appends the file lizard.fUe on the machine called lizard to the file anotherJizard.file. which also 
resides on the machine called lizard. 

Host names are given in the file /etc/hosts. Each host has one standard name (the first name 
given in the file), which is rather long and unambiguous, and optionally one or more nicknames. 
The host names for local machines are also commands in the directory /usr/hosts; if you put this 
directory in your search path then the rsh can be omitted. 

OPTIONS 

-1 UBcrnamc 

use username as the remote username instead of your local username. In the absence of 
this option, the remote username is the same as your local username. This remote name 
must be equivalent (in the sense of r/o^in(lC)) to the originating account; no provision is 
made for specifying a password with a command. 

-n redirect the input of rsh to /devfnulL You need this option if you are using csA(l) and 
put a rsA(lC) in the background without redirecting its input away from the terminal 
because it will block even if no reads are posted by the remote command. 

FILES 

/etc/hosts 

/usr/hosts/* 

SEE ALSO 

rlogin(lC) 

BUGS 

You cannot run an interactive command (like w(l)); use r/o^m(lG). 

Stop signals stop the local rsh process only; this is arguably wrong, but currently hard to fix for 
reasons too complicated to explain here. 
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NAME 

ruptime - show host status of local machines 
SYNOPSIS 

ruptime I -»11 -1 ] (-* 1 ( -« ) 

DESCRIPTION 

Ruptime gives a status line like uptime tor each machine on the local network; these are formed 
from packets broadcast by each host on the network once a minute. 

Machines for which no' status report has been received for 5 minutes are shown as being down. 

Normally, the listing is sorted by host name, but this order can be changed by specifying one of 
the options listed below. 

OPTIONS 

-• count even those users who have been idle for an hour or more. 

-1 sort the display by load average. 

>t sort the display by up time. 

“U 

sort the display by number of users. 

FILES 

/usr/spool/rwho/whod.* data files 

SEE ALSO 

rwbo(lC) 


Sun Release 1.1 


Last change: 7 March 1984 


253 





RWHO(IC) 


USER COMMANDS 


RWHO(IC) 


NAME 

rwho - who’s logged in on local machines 

SYNOPSIS 

rwho (-a J 



DESCRIPTION 

The rwho command produces output similar to who{l), but for all machines on your network. If 
no report has been received from a machine for 5 minutes, rwho assumes the machine is down, 
and does not report users last known to be logged into that machine. 

If a user hasn’t typed to the system for a minute or more, rwho reports this idle time. If a user 
hasn’t typed to the system for an hour or more, the user is omitted from the output of rwho 
unless the -a flag is given. 


OPTIONS 

--a report all users whether or not they have typed to the system in the past hour. 

FILES 

/usr/spool/rwho/whod.* information about other machines 

SEE ALSO 

ruptime(lC), rwhod(8C) 

BUGS 

Does not work through gateways. 

This is unwieldy when the number of machines on the local net is large. 



o 
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NAME 

saet - print cunent SCOS file editing activity 
SYNOPSIS 

/uar/sees/saet file t.. 

DESCRIPTION 

Saet informs the user of any SCCS files which have had one or more get -e commands applied to 
them, that is, there are files out for editing, and deltas are pending. If a directory is named on 
the command line, sect behaves as though each file in the directory were specified as a named file, 
except that non-SOCS files and unreadable files are silently ignored. If a name of - is given, the 
standard input is read with each line being taken as the name of an SCCS file to be processed. 
The output for each named file consists of five fields separated by spaces. 

Field 1 specifies the SED of a delta that currently exists in the SCCS file to which 
changes will be made to make the new delta. 

Field 2 specifies the SID for the new delta to be created. 

Field 3 contains the logname of the user who wQl make the delta (that is, executed a 

get for editing). 

Field 4 contains the date that get -e was executed. 

Field 5 contains the time that get -e was executed. 

SEE ALSO 

sces(l), delta(l), get(I), unget(l). 

Source Code Control Syotem in Programming Toole for the Sun Workstation. 

DIAGNOSTICS 

Use help(l) for explanations. 
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NAME 

sees - front end for the SCCS subsystem 
SYNOPSIS 

sees I -r } ( -^prefixpath ] ( ^pfinalpath ] command [ SCCS-flags .«.][ file ... ] 

DESCRIPTION 

The 8CC8 command is a front end to the utility programs of the Source Code Control System 
(sees), which helps them mesh more cleanly with the rest of UNDC Scc8 runs the command with 
the specified SGCS-flags and files. 

Note that 8cc8 normally prefixes each file, or the last component of each file, with the string 
SCCS/om, because you normally keep your SCCS database files in a directory called SCCS, and 
each database file starts with an 8 . prefix. 

Sees program options must appear before the command argument. Flags to be passed to the 
actual SCCS utility program must appear after the command argument. These fiags are specific to 
the command being used, and are discussed in the manual page for that command. 

Scc8 abo includes the capability to run *set user id’ to another user to provide additional protec¬ 
tion. Certain commands (such as admm) cannot be run *set user id’ by all users, since thb would 
allow anyone to change the authorizations. Such commands are always run as the real user. 

OPTIONS 

-r Runs 8CC8 as the real user rather than as whatever effective user sees b ’set user id’ to. 
--dprefizpath 

Defines the prefix portion of the pathname for the SCCS database files. The default prefix 
portion of the pathname is the current directory. Prefixpath b prefixed to the entire path¬ 
name. For example: 

tutorial^ sees -d/usr/inelude get sys/inode«li 
converts to: 

get /u8r/lnelude/8y8/SCCS/s.liiode.li 
The intent here b to create aliases such as: 

alias syssccs sees -d/usr/src 
which will be used as: 

tutorial^ eyssces get cmd/who.c 

--pfinalpath j 

Defines the name of a lower directory in which the SCCS files will be found; SCCS b the 
default. Finalpath is appended before the final component of the pathname. For exam¬ 
ple: 

tutorial% sees -pprivate get u8r/inelu<ie/8tdlo«h 

converts to: 

get u8r/include/private/8.8tdio.h 
ADDITIONAL SCCS COMMANDS 

Several ’pseudo-commands’ are available in addition to the usual SCCS commands. These are: 

admin The admin command is similar to that of the raw SCCS admin command. When creating 
new 8. files, the create command (described just below) does more of the startup work 
for you and should be used in preference to admin. 

create Create b used when creating new files. Given a C source language file called 
obscure.c. Create does the following actions: (1) creates the 8. file called 8»ob8cure.c in 
the SCCS directory; (2) renames the original source file to f 0 b 8 cure,c; (3) does an 8ce8 get 
on ob8cure*c. 

edit Get a file for editing. 

delget Perform a delta on the named files and then get new versions. The new versions have id 
keywords expanded, and so cannot be edited. 
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deledit Same as delget, but produces new versions suitable for editing. Deledit is useful for mak* 
ing a ‘checkpoint’ of your current editing phase. 

fiz Removes the named delta, but leaves you with a copy of the delta with the changes that 
were in it. Fix must be followed by a -r flag. Fix is useful for flxing small compiler 
bugs, etc. Since fix doesn’t leave audit trails, use it carefully. 

clean Removes everything from the current directory that can be recreated from SCCS files. 
Clean checks for and does not remove any files being edited. If Clean -b is used, 
branches are not checked to see if they are currently being edited. Note that —b is 
dangerous if you are keeping the branches in the same directory. 

unedit ‘Undoes’ the last edit or get -e and returns a file to its previous condition. If you unedit a 
file being edited, all changes made since the beginning of the editing session are lost. 

info Displays a list of all files being edited. It the -b flag is given, branches (that is, SID’s 

with two or fewer components) are ignored. If the -u flag is given (with an optional 
argument), only files being edited by you (or the named user) are listed. 

cheek Checks for files currently being edited, like info, but returns an exit code rather than a 

listing: nothing is printed if nothing is being edited, and a non>zero exit status is 

returned if anything is being edited. Cheek may thus be included in an ‘install’ entry in a 
makefile, to ensure that everything is included in an SCCS file before a version is 
installed. 

tell Displays a list of files being edited on the standard output. Filenames are separated by 
newlines. Takes the -b and -u flags like info and cheek. 

diffo Compares (in dtil^like format) the current version of the program you have out for editing 
and the versions in SCCS format. 

EXAMPLES 

To put a file called myprogram.e into SCCS format for the first time, assuming abo that there is 
no SCCS directory already exbting: 

tutorial% mkdlr SCCS 
tutorial^ sees ereate inyprogram.e 

myprogram.e: 

1.1 

14 lines 

after you have verified that everything ia all right 
you remove the version of the file that starts with a comma: 
tutorial% rm ,myprogramx 
tutorial^ 

To get a copy of myprogram.e for editing, edit that file, then place it back in the SCCS database: 

tutorial% sees edit myprogram.e 

1.1 

new delta 1.2 
14 lines 

tutorial% vt inyprogram.e 
your editing session 
tutorial% sees delget myprogramx 

comments? Added abusive responses for eompatibllity with rest of system 

1.2 

7 inserted 
7 deleted 
7 unchanged 
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1.2 

14 lines 
tutorial% 

To get a file from another directory: 

tntorial% sees -p/usr/arc/sccs/ get cc.c 
or: 

tutorial% sees get/u8r/sre/seca/ce*e 
To make a delta of a large number of files in the current directory: 
tutorial% sees delta *.e 

To get a list of files being edited that are not on branches: 

tutorial^ scea info -b 
To delta everything that you are editing: 

tutorial% sect delta ^scea tell -u'" 

In a makefile, to get source files from an SGCS file if it does not already exist: 

SRCS =» <list of source file8> 

$(SRCS): 

sees get $(REL) $Q 
REGULAR sees eOMMANDS 

The 'regular’ SCCS commands are described very briefly below. It is unlikely that you ever need 
to use these commands because the user interface is so complicated, and the secs front end com* 
mand does 99.9% of the interesting tasks for you. 

admin Creates new SCCS files and changes parameters of exitsing SCCS files. You can use 
acca create to create new SCCS files, or use aeea admin to do other things. 

ede Changes the commentary material in an SCCS delta. 
comb Combines SCCS deltas and reconstructs the SCCS files. 

delta Permanently introduces changes that were made to a file previously retrieved via 
acca get. You can use aeea delget as the more useful version of this command since 
acca delget does all of the useful work and more to boot. 

get Extracts a file from the SCCS database, either for compilation, or for editing when the -e 

option is used. Use acca get if you really need it, but acca delget will normally have 

done this job for you. Use acca edit instead of get with the -e option. 

help Supposed to help you interpret SCCS error messages, but usually just parrots the mes* 

saage and is generally not considered very helpful. 

prs Displays information about what is happening in an SCCS file. 
rmdel Removes a delta from an SCCS file. 

sact Displays information about editing activity in an SCCS file. The acca Info command is a 
lot more useful for the real life user. 

scesdiff Compares two versions of an SCCS file and generates the differences between the two ver¬ 
sions. The acca delget command does all this work as part of its normal process. 

unget Undoes the work of a previous get -e command or a acca edit command. Use the 
acca unedit command as a useful alternative. 

val Determines if a given SCCS file meets specified criteria. If you use the secs command, you 
shouldn’t need to use va/, because its user interface is unbelievable. 

what Displays SCCS identification information. 
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SEE ALSO 

admiii(l), comb(l), cdc(l), delta(l), get(l), help(l), pr8(l), rmdel(l), 8act(l), 8ccsdiff(l), 8cc8BIe(5), 
unget(l), val(l), what(l) 

Source Code Control Syetem in Programming Tools for the Sun Worhstation. 


o 


Sun Relea8e 1.1 


Last change: 8 March 1984 


259 




SCCSDIFF(l) 


USER COMMANDS 


SCCSDIFF(l) 


NAME 

sccsdiff - compare two versions of an SCCS file 



SYNOPSIS 

/usr/necs/Bcesdlff -r SIDl -t SIDS ( -p J ( -b n j files 
DESCRIPTION 

Sccadiff compares two versions of an SCCS file and generates the differences between the two ver¬ 
sions. Any number of SCCS files may be specified, but options apply to all files. 

OPTIONS 

—tSIDf SIDl and SIDS specify the deltas of an SCCS file that are to be compared. Versions 
are passed to diJS{l) in the order given. 

-p pipe output for each file through pr(l). 

-■n n is the file segment size that bdiff will pass to diJS[l). This is useful when diff fails 

due to a high system load. 

FILES 

/tmp/get????? Temporary files 
SEE ALSO 

8ccs(I), bdiff(I), get(l), help(I), pr(I). 

Source Code Control Syetem in Programming Toole for the Sun Workstation. 

DIAGNOSTICS 

‘*JUe: No differences” If the two versions are the same. 

Use help{l) for explanations. 




w 
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NAME 

Mript - make typescript of terminal session 

SYNOPSIS 

script { -• ] { file I 

DESCRIPTION 

Script makes a typescript of everything printed on your terminal. The typescript is written to 
file, or appended to file it the -a option is given. It can be sent to the line printer later with Ipr. 
If no file name is given, the typescript is saved in the file typeaeript. 

The script ends when the forked shell exits. 

OPTIONS 

Append the script to the specified file instead of writing over it. 

BUGS 

Script places everything in the log file. This is not what the naive user expects. 
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NAME 

sed - stream editor 
SYNOPSIS 

sed ( -n ) ( -^ script J [ -f sfile ] [ file | • 

DESCRIPTION 

Sed copies the named files (standard input default) to the standard output, edited according to a 
script of commands. 

OPTIONS 

-e Is a list of edit commands for sed. If there is just one -e option and no -fs, the -e fiag 
-e may be omitted, 

-f Take the script from efile 

-n suppress the default output. 

SED SCRIPTS 

■ed scripts consist of editing commands, one per line, of the following form: 

[address [, address] ] function (arguments) 

In normal operation sed cyclically copies a line of input into a pattern space (unless there is some¬ 
thing left after a 'D’ command), applies in sequence all commands whose addresses select that 
pattern space, and at the end of the script copies the pattern space to the standard output 
(except under -n) and deletes the pattern space. 

An address is either a decimal number that counts input lines cumulatively across files, a that 
addresses the last line of input, or a context address, expression/’, in the style of fd(l) 

modified thus: 

The escape sequence ’\n’ matches a newline embedded in the pattern space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that matches the address. 

A command line with two addresses selects the inclusive range from the first pattern space that 
matches the first address through the next pattern space that matches the second. If the second 
address is a number less than or equal to the line number first selected, only one line is selected. 
Thereafter the process is repeated, looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by use of the negation func¬ 
tion (below). 

In the following list of functions the maximum number of permissible addresses for each function 
is indicated in parentheses. 

An argument denoted text consists of one or more lines, all but the last of which end with *\’ to 
hide the newline. Backslashes in text are treated like backslashes in the replacement string of an 
*s’ command, and may be used to protect initial blanks and tabs against the stripping that is done 
on every script line. 

An argument denoted rfile or wfile must terminate the command line and must be preceded by 
exactly one blank. Each wJUe is created before processing begins. There can be at most 10 dis¬ 
tinct wfile arguments. 

(l)a\ 

text 

Append: Place text on the output before reading the next input line. 

{2)h label 

Branch to the command bearing the label. Branch to the end of the script if label is 
empty. 
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(2)c\ 

Uxt 

Change: Delete the pattern space. With 0 or 1 address or at the end of a 2-address range, 
place ttxt on the output. Start the next cycle. 

(2)d Delete the pattern space. Start the next cycle. 

(2)D Delete the initial segment of the pattern space through the first newline. Start the next 
cycle. 

(2)g Replace the contents of the pattern space by the contents of the hold space. 

(2)G Append the contents of the hold space to the pattern space. 

(2) h Replace the contents of the hold space by the contents of the pattern space. 

(2)H Append the contents of the pattern space to the hold space. 

(1) i\ 

text 

Insert: Place text on the standard output. 

(2) n Copy the pattern space to the standard output. Replace the pattern space with the next 

line of input. 

(2)N Append the next line of input to the pattern space with an embedded newline. (The 
current line number changes.) 

(2)p Print: Copy the pattern space to the standard output. 

(2)P Copy the initial segment of the pattern space through the first newline to the standard 
output. 

(1) q Quit: Branch to the end of the script. Do not start a new cycle. 

(2) r rfile 

Read the contents of rfile. Place them on the output before reading the next input line. 
regular expresrienf reptaeementjfiagt 

Substitute the replacement string for instances of the regular expreaeion in the pattern 
space. Any character may be used instead of For a fuller description see ed(l). 
Flaga is sero or more of 

g Global: Substitute for all nonoverlapping instances of the regular expression 
rather than just the first one. 

p Print the pattern space if a replacement was made, 
w wfile Write: Append the pattern space to wfite if a replacement was made. 

(2)t label 

Test: Rranch to the command bearing the label if any substitutions have been made 
since the most recent reading of an input line or execution of a ‘t’. If label is empty, 
branch to the end of the script. 

(2)w wfile 

Write: Append the pattern space to wfile. 

(2)x Exchange the contents of the pattern and hold spaces. 

{2)y Istringllatring2f 

Transform: Replace all occurrences of characters in stringl with the corresponding char¬ 
acter in strings. The lengths of stringl and strings must be equal. 

(2)! function 

Don’t: Apply the function (or group, if function is ‘{’) only to lines not selected by the 
addre88(e8). 
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(0): label 

This commaDd does nothing; it bears a label for ‘b’ and *t’ commands to branch to. 

(1) s Place the current line number on the standard output as a line. 

(2) { Execute the following commands through a matching *}’ only when the pattern space is 

selected. 

(0) An empty command is ignored. 

SEE ALSO 

ed(l), grep(l), awk(l), lex(l) 

Using aed, the Stream Text Editor in Editing and Text Proeeaaing on the Sun Workstation. 
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NAME 

sh, for, case, if, while, t, ., break, continue, cd, eval, exec, exit, export, login, newgrp, read, 
readonly, set, shift, times, trap, umask, wait - command language 

SYNOPSIS 

sh {-ceiknrstuvx ] ( arg ]... 

DESCRIPTION 

5k is a command programming language that executes commands read from a terminal or a file. 
See invocation for the meaning of arguments to the shell. 

Commsmds. 

A simple-command is a sequence of non blank words separated by blanks (a blank is a tab or a 
space). The first word specifies the name of the command to be executed. Except as specified 
below the remaining words are passed as arguments to the invoked command. The command 
name is passed as argument 0 (see ezeeve{2)). The value of a simple-command is its exit status if 
it terminates normally or 200+ status if it terminates abnormally (see sigvee(2} tor a list of status 
values). 

A pipeline is a sequence of one or more commands separated by ]. The standard output of each 
command but the last is connected by a pipe(2) to the standard input of the next command. 
Each command is run as a separate process; the shell waits for the last command to terminate. 

A list is a sequence of one or more pipelines separated by ;, &, && or j | and optionally ter¬ 
minated by ) or &. { and & have equal precedence which is lower than that of SlSl and 11; StSt 
and 11 also have equal precedence. A semicolon causes sequential execution; an ampersand causes 
the preceding pipeline to be executed without waiting for it to finish. The symbol && causes the 
list following to be executed only if the preceding pipeline returns a zero value. The symbol 11 
causes the list following to be executed only if the preceding pipeline returns a non zero value. 
Newlines may appear in a list, instead of semicolons, to delimit commands. 

A command is either a simple-command or one of the following. The value returned by a com¬ 
mand is that of the last simple-command executed in the command. Note that many keywords 
such as dons are only recognized when they are the first keyword on a line, 
for name [ in word ... ] 
do 
list 
done 

Each time a for command is executed name is set to the next word in the In word list. If 
in word... is omitted, in $0 is assumed. Execution ends when there are no more words in the 
list. 

ease word in 

I pattern ( | pattern |... ) lisi ;; 

I pattern [ j pattern ]. ■. ) list n 

esae 

A ease command executes the list associated with the first pattern that matches word. The form 
of the patterns is the same as that used tor file name generation, 
if list 
then list 
[emiist 
then list ] ... 

[ else 
list ] 
fl 
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The list following If is executed and if it returns zero the list following then is executed. Other¬ 
wise, the list following ellf is executed and if its value is zero the list following then is executed. 
Failing that the else list is executed. 

while list 
[ do 
list ] 

done 

A while command repeatedly executes the while list and if its value is zero executes the do list; 
otherwise the loop terminates. The value returned by a while command is that of the last exe¬ 
cuted command in the do list until may be used in place of while to negate the loop terminar 
tion test. 

( list ) Execute list in a subshell. 

{ list } list is simply executed. 

The following words are only recognized as the first word of a command and when not quoted. 

if then else elif fl case esae for while until do done { } 

Command substitution. 

The standard output from a command enclosed in a pair of back quotes ') may be used as part 
or all of a word; trailing newlines are removed. 

Parameter substitution. 

The character $ is used to introduce substitutable parameters. Positional parameters may be 
assigned values by set. Variables may be set by writing 

name=svalue [ name^value] ... 

$ {parameter} 

A parameter is a sequence of letters, digits or underscores (a name), a digit, or any of the 
characters * O # f - $ !• The value, if any, of the parameter is substituted. The braces 
are required only when parameter is followed by a letter, digit, or underscore that is not 
to be interpreted as part of its name. If parameter is a digit, it is a positional parameter. 
If parameter is * or Q then all the positional parameters, starting with $1, are substituted 
separated by spaces. $0 is set from argument zero when the shell is invoked. 

t {parameter-word} 

If parameter is set, substitute its value; otherwise substitute word, 

$ {parameter^ word} 

If parameter is not set, set it to word; the value of the parameter is then substituted. 
Positional parameters may not be assigned to in this way. 

$ {parameter f word } 

If parameler is set, substitute its value; otherwise, print word and exit from the shell. If 
word is omitted, a standard message is printed. 

$ {parameter + word} 

If parameter is set, substitute word; otherwise substitute nothing. 

In the above word is not evaluated unless it is to be used as the substituted string. (So that, for 
example, echo ${d-‘'pwd '} will only execute pwd if rf is unset.) 

The following parameters are automatically set by the shell. 

# The number of positional parameters in decimal. 

— Options supplied to the shell on invocation or by set. 

r The value returned by the last executed command in decimal. 

$ The process number of this shell. 

! The process number of the last background command invoked. 


266 


Last change: 8 March 1984 


Sun Release 1.1 




SH(1) 


USER COMMANDS 


SH(1) 


The following parametert are used but not set by the shell. 

HOME The default argument (home directory) for the ed command. 

PATH The search path for commands (see execution). 

MAIL If this variable is set to the name of a mail file, the shell informs the user of the 
arrival of mail in the specified file. 

PSl Primary prompt string, by default ’$ ’. 

PS2 Secondary prompt string, by default 

IFS Internal field separators, normally apace, tab, and newline. 

Blank Interpretatlop. 

After parameter and command substitution, any results of substitution are scanned for internal 
field separator characters (those found in $IFS) and split into distinct arguments where such char- 
acters are found. Explicit null arguments (”” or ") are retained. Implicit null arguments (those 
resulting from parametert that have no values) are removed. 

File name generation. 

Following substitution, each command word is scanned for the characters *, T and [. If one of 
these characters spears, the word is regarded as a pattern. The word is replaced with alphabeti¬ 
cally sorted file names that match the pattern. If no file name is found that matches the pattern, 
the word is left unchanged. The character • at the start of a file name or immediately following 
a /, and the character /, must be matched explicitly. 

* Matches any string, including the null string. 

T Matches any single character. 

[...] Matches any one of the characters enclosed. A pair of characters separated by - matches 
any character lexically between the pair. 

Quoting. 

The following characters have a special meaning to the shell and cause termination of a word 
unless quoted. 

I & ( ) I < > newline space tab 

A character may be quoted by preceding it with a backslash (\) character, \newllne b ignored. 
All characters enclosed between a pair of quote marks ("), except a single quote, are quoted. 
Inside double quotes (* *) parameter and command substitution occurs and \ quotes the charac¬ 
ters backslash (\), apostrophe ('), double quote (”), and dollar sign ($). 

is equivalent to "ll 12..." whereas 
” 10 ” is equivalent to *$1* *$2” ... 

Prompting. 

When used interactive^, the shell prompts with the value of PSl before reading a command. If 
at any time a newline is typed and further input is needed to complete a command, the secondary 
prompt ($PS3) is displayed. 

Input output. 

Before a command is executed its input and output may be redirected using a special notation 
interpreted by the shell. The following may appear anywhere in a simple-command or may pre¬ 
cede or follow a command and are not passed on to the invoked command. Substitution occurs 
before word or digit is used. 

< word Use file word as stmidard input (file descriptor 0). 

> word Use file word as standard output (file descriptor 1). If the file does not exist, it is created; 
otherwise it is truncated to zero length. 

>> word 

Use file word as standard output. If the file exbts, output b appended (by seeking to the 
end); otherwise the file b created. 
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<< word 

The shell input is read up to a line the same as word, or end of file. The resulting docu¬ 
ment becomes the standard input. If any character of word is quoted, no interpretation is 
placed upon the characters of the document; otherwise, parameter and command substi¬ 
tution occurs, \newline is ignored, and \ is used to quote the characters backslash (\), 
dollar sign (I), apostrophe ('), and the first character of word. 

< & digit 

The standard input is duplicated from file descriptor digit; see dup{2). Similarly for the 
standard output using >. 

< & - The standard input is closed. Similarly for the standard output using >. 

If one of the above is preceded by a digit, the file descriptor created is that specified by the digit 
(instead of the default 0 or 1). For example, 

...2>&1 

creates file descriptor 2 to be a duplicate of file descriptor 1. 

If a command is followed by & then the default standard input for the command is the empty file 
(/dev/null). Otherwise, the environment for the execution of a command contains the file 
descriptors of the invoking shell as modified by input output specifications. 

Environment. 

The environment is a list of name-value pairs that is passed to an executed program in the same 
way as a normal argument list; see execve(2) and entn>on(5). The shell interacts with the environ¬ 
ment in several ways. On invocation, the shell scans the environment and creates a parameter for 
each name found, giving it the corresponding value. Executed commands inherit the same 
environment. If the user modifies the values of these parameters or creates new ones, none of 
these affects the environment unless the export command is used to bind the shell’s parameter to 
the environment. The environment seen by any executed command is thus composed of any 
unmodified name-value pairs originally inherited by the shell, plus any modifications or additions, 
all of which must be noted in export commands. 

The environment for any simple-command may be augmented by prefixing it with one or more 
assignments to parameters. Thus these two lines are equivalent 

TERM=450 cmd args 

(export TERM; TERM—450; cmd args) 

If the -k flag is set, all keyword arguments are placed in the environment, even if they occur after 
the command name. The following prints ’a=b c’ and ’c’: 

echo a=*i) c 
set -k 
echo a««b c 

Signals. 

The INTERRUPT and QUIT signals for an invoked command are ignored if the command is fol¬ 
lowed by &; otherwise signals have the values inherited by the shell from its parent. (But see 
also trap*) 

Execution. 

Each time a command is executed the above substitutions are carried out. Except for the ’special 
commands’ listed below a new process is created and an attempt is made to execute the command 
via an execve{2). 

The shell parameter $PATH defines the search path for the directory containing the command. 
Each alternative directory name is separated by a colon (:). The default path is s/blns/usr/bln. 
If the command name contains a /, the search path is not used. Otherwise, each directory in the 
path is searched for an executable file. If the file has execute permission but is not an a.out file, it 
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is assumed be a file containing shell commands. A sobsbell (that is, a separate process) is 
spawned to read it. A parenthesized command is also executed in a subshell. 

Special commands. 

The following commands are executed in the shell process and except where specified no input 
output redirection is permitted for such commands. 

t No effect; the command does nothing. 

. file Read and execute commands from file mid return. The search path IPATH is used to 
find the dimctory containing file. 
break | n] 

Exit from the enclosing for while loop, if any. If n is specified, break n levels, 
continue (n) 

Resume the next iteration of the enclosing for or while loop. If n is specified, resume at 
the n*th enclosing loop, 
ed ( arg\ 

Change the current directory to arg. The shell parameter IHOMB is the default arg. 
aval (cry... j 

The arguments are read as input to the shell and the resulting command(8) executed, 
exec [arg ...] 

The command specified by the arguments is executed in place of this shell without creat¬ 
ing a new process. Input output arguments may appear and if no other arguments are 
given cause the shell input output to be modified. 

exit in] 

Causes a non interactive shell to exit with the exit status specified by n. If n is omitted, 
the exit status is that of the last command executed. (An end of file will also exit from 
the shell.) 
export (name...) 

The given names are marked for automatic export to the eninronment of subsequently- 
executed commands. If no arguments are given, a list of exportable names is printed, 
login (arg... I 

Equivalent to /exec login arg ...’. 
newgrp (arg...] 

Equivalent to 'exec newgrp arg ...’. 
read name... 

One line is read from the standard input; successive words of the input are assigned to 
the variables name in order, with leftover words to the last variable. The return code is 0 
unless the end-of-file is encountered, 
roadonly (name ... ( 

The given names are marked readonly and the values of the these names may not be 
changed by subsequent assignment. If no arguments are given, a list of all readonly 
names is printed. 

■ot (-oknptuYX {arg ... ] ] 

-• If non interactive, exit immediately if a command fails. 

— k All keyword arguments are placed in the environment for a command, not just 

those that precede the command name. 

—n Read commands but do not execute them. 

—t Exit after reading and executing one command. 

—tt Treat unset variables as an error when substituting. 

—V Print shell input lines as they are read. 

—X Print commands and their arguments as they are executed. 

— Turn off the -x and ~v options. 
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These flags can also be used upon invocation of the shell. The current set of flags may be 
found in . 

Remaining arguments are positional parameters mid are assigned, in order, to $1, $2, etc. 
If no arguments are given, the values of all names are printed. 

shift The positional parameters from $2... are renamed $1... 

times Print the accumulated user and system times for processes run from the shell. 

trap |arg] (n] ... 

Arg is a command to be read and executed when the shell receives signals) n. (Note that 
arg is scanned once when the trap is set and once when the trap is taken.) Trap com* 
mands are executed in order of signal number. If arg is absent, all trap(s) n are reset to 
their original values. If arg is the null string, this signal is ignored by the sheU and by 
invoked commands. If n is 0, the command arg is executed on exit from the shell, other* 
wise upon receipt of signal n as numbered in 8igvec{2). Trap with no arguments prints a 
list of commands associated with each signal number. 

umasklnnn] 

The user file creation mask is set to the octal value nnn (see umaek(2)). If nnn is omitted, 
the current value of the mask is printed. 

wait I n] 

Wait for the specified process and report its termination status. If n is not given, all 
currently active child processes are waited for. The return code from this command is 
that of the process waited for. 

Invocation. 

If the first character of argument zero is -, commands are read from $HOME/. profile, if such a 
file exists. Commands are then read as described below. The following flags are interpreted by 
the shell when it is invoked. 

-e string If the -e flag is present, commands are read from string. 

-a If the -a flag is present or if no arguments remain then commands are read from the 

standard input. Shell output is written to file descriptor 2. 

-1 If the -1 flag is present or if the shell input and output are attached to a terminal (as 

told by gtty) then thu shell is interactive. In this case the terminate signal 
SIGTE^M (see 8igvee{2)) is ignored (so that ’kill 0’ does not kill an interactive shell) 
and the interrupt signal SIGINT is caught and ignored (so that watt is interrupt* 
able). In all cases SIGQUIT is ignored by the shell. 

The remaining flags and arguments are described under the set command. 

FILES 

IHOME/. profile 
/tmp/sh* 

/dev/nuU 

SEE ALSO 

Using the Bourne SheU in the Beginner's Guide to the Sun Workstation 
C8h(l), test(l), execve(2). 

DIAGNOSTICS 

Errors detected by the shell, such as syntax errors, cause the shell to return a non zero exit 
status. If the shell is being used non interactively then execution of the shell file is abandoned. 
Otherwise, the shell returns the exit status of the last command executed (see abo exit). 

BUGS 

If « is used to provide standard input to an asynchronous process invoked by &, the shell gets 
mixed up about naming the input document. A garbage file /trop/sh* u created, and the shell 
complains about not being able to find the file by another name. 
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NAME 

size - size of an object file 

SYNOPSIS 

•In I object... ] 

DESCRIPTION 

Size prints the (decimal) number of bytes required by the text, data, and bss portions, and their 
sum in hex and decimal, of each object-file argument. If no file is specified, a.eul is used. 

SEE ALSO 

a.out(5) 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to execute a command after a certain 
amount of time as in: 

(sleep 105; command)& 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 



SEE ALSO 

8etitimer(2), sleep(3) 

BUGS 

Time must be less than 2,147,483,647 seconds. 


o 
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NAME 

80 «lim - eliminate .so's from nroff input 

SYNOPSIS 

soellm I file ... ] 

DESCRIPTION 

Sotlim reads the specified files or the standard input and performs the textual inclusion implied 
by the nro^directives of the form 

.sosomefile 

when they appear at the beginning of input lines. This is useful since programs such as 161 do not 
normally do this; it allows the placement of individual tables in separate files to be run as a part 
of a large document. 

An argument consisting of a single minus (-) is taken to be a file name corresponding to the stan* 
dard input. 

Note that inclusion can be suppressed by using ' " instead of '. that is, 

'so /usr/lib/tmae.s 

EXAMPLE 

A sample usage of soelim would be 

soelim exumf.n | tbl | nroff -ms | col | Ipr 

SEE ALSO 

colcrt(l), more(l) 

BUGS 

The format of the source commands must involve no strangeness - exacts one space must pre¬ 
cede and no spaces follow the file name. 
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NAME 

sort - sort or merge files 
SYNOPSIS 

»ort [ -mubdflnrtx ][+po8l [ -posS ] ] • • • | -o name j | -T directory J [ file ] • • • 
DESCRIPTION 

Sort sorts lines of all the named files together and writes the result on the standard output The 
name means the standard input. If no input file*n are named, the standard input is sorted. 

The default sort key is an entire line. Default ordering is lexicographic by bytes in machine col¬ 
lating sequence. 

The notation +po8l -^posS restricts a sort key to a field beginning at pool and ending just before 
po82. Pool and pooS each have the form m.n, optionally followed by one or more of the fiags 
bdfinri where m tells a number of fields to skip from the beginning of the line and n tells a 
number of characters to skip further. If any flags are present they override all the global ordering 
options for this key. If the b option is in effect n is counted from the first nonblank in the field; b 
is attached independently to po82. A missing .n means .0; a missing -pooS means the end of the 
line. Under the -tx option, fields are strings separated by x; otherwise fields are nonempty non¬ 
blank strings separated by blanks. 

When there are multiple sort keys, later keys are compared only after all earlier keys compare 
equal. Lines that otherwise compare equal are ordered with all bytes significant. 

OPTIONS 

The ordering is affected globally by the following options, one or more of which may appear, 
b Ignore leading blanks (spaces and tabs) in field comparisons, 
d ‘Dictionary’ order: only letters, digits and blanks are significant in comparisons, 
f Fold upper case letters onto lower case. 

t Ignore characters outside the ASCII range 040-0176 in nonnumeric comparisons. 

n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or 
more digits with optional decimal point, is sorted by arithmetic value. Option n implies 
option b. 

r Reverse the sense of comparisons, 
tx Tab character* separating fields is x. 

These option arguments are also understood: 

e Check that the input file is sorted according to the ordering rules; give no output unless the 
file is out of sort. 

m Merge only, the input files are already sorted, 
o name 

name is the name of an output file to use instead of the standard output. This file may be 
the same as one of the inputs. 

T directory 

directory argument is the name of a directory in which temporary files should be made. 

u Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do not 
participate in this comparison. 

EXAMPLES 

Print in alphabetical order all the unique spellings in a list of words. Capitalized words differ 
from uncapitalized. 
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sort -u + Of + 0 list 

Print the password file (pa<«u;d(5)) sorted by user id number (the 3rd colon-separated field), 
sort -t: + 2n /etc/passwd 

Print the first instance of each month in an already sorted file of (month day) entries. The 
options -um with just one input file make the choice of a unique representative from a set of 
equal lines predictable. 

sort -um 4- 0 -1 dates 

FILES 

/usr/tmp/stm*, /tmp/* first and second tries for temporary files 
SEE ALSO 

oniq(l), comm(l), rev(l), join(l) 

DIAGNOSTICS 

Comments and exits with nonzero status for various trouble conditions and for disorder 
discovered under option -c. 

BUGS 

Very long lines are silently truncated. 
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NAME 

sortbib - sort bibliographic database 
SYNOPSIS 

sortbib [ -sKBYS ) database ... 

DESCRIPTION 

Sortbib sorts files of records containmg refer key-letters by user-specified keys. Records may be 
separated by blank lines, or by .[ and .) delimiters, but the two styles may not be mixed together. 
This program reads through each database and pulls out key fields, which are sorted separately. 
The sorted key fields contain the file pointer, byte offset, and length of corresponding records. 
These records are delivered using disk seeks and reads, so eortbib may not be used in a pipeline to 
read standard input. 

By default, sortbib alphabetizes i)y the first %A and the %D fields, which contain the senior 
author and date. The -s option is used to specify new KEYS. For instance, -sATD will sort by 
author, title, and date, while -sA-f D will sort by all authors, and date. Sort keys past the fourth 
are not meaningful. No more than 16 databases may be sorted together at one time. Records 
longer than 4096 characters will be truncated. 

Sortbib sorts on the last word on the %A line, which is assumed to be the author’s last name. A 
word in the final position, such as “jr.” or *'ed.”, will be ignored if the name beforehand ends 
with a comma. Authors with two-word last names or unusual constructions can be sorted 
correctly by using the nrcjf convention **\0” in place of a blank. A %Q field is considered to be 
the same as %A, except sorting begins with the first, not the last, word. Sortbib sorts on the last 
word of the %D line, usually the year. It also ignores leading articles (like ‘‘A” or “The”) when 
sorting by titles in the %T or % J fields; it will ignore articles of any modern European language. 
If a sortrsignificant field is absent from a record, places that record before other records 

containing that field. 

SEE ALSO jvr v 

refer(l), addbib(I), roibib(l), indxbib(l), lookbib(l) 

BUGS 

Records with missing author fields should probably be sorted by title. 
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NAME 

spell, spelliiii spellottt - find spelling errors 
SYNOPSIS 

spell ( -V ] I —b I ( -d hlist | ( -s hstop ] (— h spellhist ] [ file ) ... 
spellin (list | 
spellout (-d ] list 
DESCRIPTION 

Spell collects words from the named documents, and looks them up in a spelling list. Words that 
neither occur among nor are derivable (by applying certain infiections, prefixes or suffixes) from 
words in the spelling list are printed on the standard output. If no files are named, words are col¬ 
lected from the standard input. 

Spell ignores most troff(l), tbl{l), and e 9 n(l) constructions. 

The spelling list is based on many sources, and while more haphazard than an ordinary diction¬ 
ary, is also more effective in respect to proper names and popular technical words. Coverage of 
the specialized vocabularies of biology, medicine and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated below with their default 
settings. Copies of all output are accumulated in the history file. The stop list filters out misspel¬ 
lings (for example, thierasthy-y-1- ier) that would otherwise pass. 

Two routines help maintain the hash lists used by tpell. Both expect a list of words, one per line, 
from the standard input. Spellin adds the words on the standard input to the preexisting list and 
places a new list on the standard output. If no Hat is specified, the new list is created from 
scratch. Spellout looks up each word in the standard input and prints on the standard output 
those that are missing from (or present on, with option -d) the hash list. 


OPTIONS 

-V Print all words not literally in the spelling list, as well as plausible derivations from spel¬ 
ling list words. 


-b Check British spelling. Besides preferring centre, colour, epeeiality, travelled, and so on, 
the -b option insists upon -tee in words like etandardise, Fowler and the OED to the con¬ 
trary notwithstanding. 


-» print every plausible stem with for each word. 


FILES 

/usr/dict/hlist|ab] 
/usr/dict/hstop 
/ usr/dict/spellhist 
/usr/dict/words 
/usr/lib/spell 


hashed spelling lists, American & British 
hashed stop list 
history file 
list of words 


SEE ALSO 

deroff(l), sort(l), tee(l), sed(l) 


BUGS 

The spelling list’s coverage is uneven; new installations will probably wish to monitor the output 
for several months to gather local additions. 


British spelling was done by an American. 
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NAME 

spline - interpolate smooth curve 
SYNOPSIS 

spline ( -a ) ( -k ) ( -n j ( -p ) I -X ) 

DESCRIPTION 

Spline takes pairs of numbers from the standard input as abcissas and ordinates of a function. It 
produces a similar set, which is approximately equally spaced and includes the input set, on the 
standard output. The cubic spline output (R. W. Hamming, Numerical Methods for Scientists and 
Engineers, 2nd ed., 34dff) has two continuous derivatives, and sufficiently many points to look 
smooth when plotted, for example by grapk(lG), 

OPTIONS 

-a Supply abscissas automatically (they are missing from the input); spacing is given by the 
next argument, or is assumed to be 1 if next argument is not a number. 

-k The constant k used in the boundary value computation 

is set by the next argument. By default k — 0. 

-n Space output points so that approximately n intervals occur between the lower and upper x 
limits. (Default n » 100.) 

-p Make output periodic, that is, match derivatives at ends. First and last input values should 
normally agree. 

-X Next 1 (or 2) arguments are lower (and upper) x limits. Normally these limits are calculated 
from the data. Automatic abcissas start at lower limit (default 0). 

SEE ALSO 

graph(lG) 

DIAGNOSTICS 

When data is not strictly monotonic in x, epline reproduces the input without interpolating extra 
points. 

BUGS 

A limit of 1000 input points is enforced silently. 
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NAME 

split - split aifile into pieces 
SYNOPSIS 

split [ -n ] I file ( name ] ] 

DESCRIPTION 

Split reads JUe and writes it in n>line pieces (default 1000) onto a set of output files (as many files 
as necessary). The name of the first output file is name with ma appended, the second file is 
nameab, and so on lexicographically. 

If no name is given, x is used as default (output files will be called zaa, xah, etc.). 

If no input file is given, or if - is given in its stead, then the standard input file is used. 

OPTIONS 

-n Number of lines in each piece. 
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NAME 

strings - find printable strings in an object, or other binary, file 
SYNOPSIS 

strings [-][-o I (-number ] file ... 

DESCRIPTION 

Strings looks for ascii strings in a binary file. A string is any sequence of 4 or more printing char* 
acters ending with a newline or a null. 

Strings is useful for identifying random object files and many other things. 

OPTIONS 

- Look everywhere in the file for strings. If this flag is omitted, strings only looks in the 
initialized data space of object files. 

*-o Precede each string by its offset in the file (in octal). 

-number 

Use number as the minimum string length rather than 4. 

SEE ALSO 
od(l) 

BUGS 

The algorithm for identifying strings is extremely primitive. 
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NAME 

strip - remove qrmbob and relocation bits 

SYNOPSIS 

strip name... 

DESCRIPTION 

Strip removes the symbol table and relocation bits ordinarily attached to the output of the assem¬ 
bler and loader. This is useful to save space after a program has been debugged. 

The effect of ttrip is the same as use of the -s option of Id. 

FILES 

/tmp/stm? temporary file 

SEE ALSO 
ld(l) 
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NAME 

stty - set terminal options 

SYNOPSIS 

stty I option ... ] 

DESCRIPTION 

Sity sets certain I/O options on the current output terminal, and directs its output to the diagnos* 
tic output. With no argument, it reports the speed of the terminal and the settings of options 
which are different from their defaults. With the argument *'all”, all normally-used option set^ 
tings are reported. With the argument '*everything’*, everything sity knows about is printed. 

OPTIONS 

Options to stty are selected from the following set: 

even allow even parity input 

-even disallow even parity input 

odd allow odd parity input 

-odd disallow odd parity input 

raw raw mode input (no input processing (erase, kill, interrupt, ...); parity bit passed back) 
-raw negate raw mode 

cooked same as -raw* 

cbreak make each character available to Ttad(2) as received; no erase and kUl processing, but 
all other processing (interrupt, suspend, ...) is performed 
-cbreak make characters available to rtad only when newline is received 
-nl allow carriage return for new-line, and output CR-LF for carriage return or new-line 

nl accept only new-line to end lines 

echo echo back every character typed 

-echo do not echo characters 

lease map upper case to lower case 

-lease do not map case 

tandem enable flow control, so that the system sends out the stop character when its internal 

queue is in danger of overflowing on input, and sends the start character when it is 
ready to accept further input 
-iatndem disable flow control 

-tabs replace tabs by spaces when printing 

tabs preserve tabs 

ek set erase and kill characters to "H (controI-H) and "U 

For the following commands which take a character argument c, you may also specify c as the 
’"u” or **undef”, to set the value to be undefined. A value of a 2 character sequence, is also 
interpreted as a control character, with “*?’* representing delete. 

erase c set erase character to c (default ‘*7*). 
kill c set kill character to c (default '"U’). 

Intr c set interrupt character to c (default **0*). 
quit e set quit character to c (default 

start c set start character to c (default *^Q*). 

stop c set stop character to c (default '"S*). 

cof e set end of file character to c (default 

brk c set break character to c (default undefined.) This character is an extra wakeup causing 
character. 
crO crl ct2 cr3 

select style of delay for carriage return (see iocil(2)) 
nlO nil nl2 nl3 

select style of delay for linefeed 
tabO tabl tab2 tabS 

select style of delay for tab 
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m fft select style of delay for form feed 

bsO bil select style of delay for backspace 

tty33 set all modes suitable for the Teletype Corporation Model 33 terminal. 

tty37 set all modes suitable for the Teletype Corporation Model 37 terminal. 

vt05 set all modes suitable for Digital Equipment Corp. VT05 terminal 

dec set all modes suitable for Digital Equipment Corp. operating systems users; (erase, kill, 

and interrupt characters to "7, "U, and "C, decctlq and “newcrt”.) 

tn300 set all modes suitable for a General Electric TermiNet 300 

ti700 set all modes suitable for Texas Instruments 700 series terminal 

tek set all modes suitable for Tektronix 4014 terminal 

0 hang up phone line immediately 

50 76 110 134 150 200 300 000 1200 1800 2400 4800 9000 exta extb 

Set terminal baud rate to the number given, if possible. (These are the speeds sup¬ 
ported by the DH-11 interface). 

The driver which supports the job control processing of C9A(1) is fully described in tty{4). The 
options in the list below can only be selected by using the new option to 

new Use new driver (switching flushes typeahead). 

crt Set options for a CRT (crtbs, ctlecho and, if >= 1200 baud, crterase and crtkill.) 

crtbs Echo backspaces on erase characters. 

prteraae For printing terminal echo erased characters backwards within and *7’’* 
crterase Wipe out erased characters with '^backspace-space-backspace.” 

-crterase Leave erased characters visible; just backspace. 
crtklU Wipe out input on like kill ala crterase* 

-crtkIII Just echo line kill character and a newline on line kill. 

ctlecho Echo control characters as ** V (and delete as Print two backspaces following 
the EOT character (default ‘*D’). 

-ctlecho Control characters echo as themselves; in cooked mode EOT (default *"D’) is not 
echoed. 

decctlq After output is suspended (normally by "S), only a start character (normally "Q) will 
restart it. This is compatible with DEC’s vendor supplied systems. 

-decctlq After output is suspended, any character typed will restart it; the start character will 
restart output without providing any input. (This is the default.) 
tostop Background jobs stop if they attempt terminal output. 

-tostop Output from background jobs to the terminal is allowed, 
tilde Convert ***” to on output (for Hazeltine terminals). 

-tlld® Leave poor alonel 

fii£@ho Output is being discarded usually because user hit '"O’ (internal state bit). 

-fiusho Output is not being discarded. 

pendlsn Input is pending after a switch from cbreak to cooked and will be re-input when a 
read becomes pending or more input arrives (internal state bit). 

-pendlsi Input is not pending. 

Intrup Send a signal (SIGTINT) to the terminal control process group whenever an input 
record (line in cooked mode, character in cbreak or raw mode) is available for reading, 
-intpup Don’t send input available interrupts, 
mdmbuf Start/stop output on carrier transitions (not implemented). 

-mdmbuf - 

Return error if write attempted after carrier drops, 
litout Send output characters without any processing. 

-Utout Do normal output processing, inserting delays, etc. 
noh&ng Don’t send hangup signal if carrier drops. 

—nohang Send hangup signal to control process group when carrier drops. 
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etxaek Diablo style etx/ack handshaking (not implemented). 

The following special characters are applicable only to the new teletype driver and are not nor¬ 
mally changed. 

SUSP e set suspend process character to e (default “Z’). 
dsusp e set delayed suspend process character to c (default '*Y’). 
rprnt e set reprint line character to e (default ‘"R’). 
flush e set flush output character to e (default ‘*0’). 
werase c set word erase character to e (default ‘"W’). 

Inext e set literal next character to c (default ‘*V’). 

SEE ALSO 

ioctl(2), tset(l), tty(4) 
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NAME 

•u - substitute user id temporarily 
SYNOPSIS 

stt I u$erMme \ (•« eommani ] 

DESCRIPTION 

Su chaoses your lofio to that of the specified username. Su asks for the password, just as if you 
were logging in as usernsme, and, if the password is given, changes to that username and invokes 
the shell specified in the password file for that username, without changing the cunent directory. 
The user environment is thus unchanged except for HOME and SHEHiL, which are taken from the 
password file for the user being substituted (see entnVsn(5)). The new user ID stays in force untQ 
the shell exits. 

If no username is specified, ‘root’ is assumed. To remind the super^user of his responsibilities, the 
Shell substitutes *#’ for its usual prompt. 

OPTIONS 

-e command 

execute command after logging in as the new user. 

SEEALSO 

sh(l), csh(l) 
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NAME 

sum - sum and count blocks in a file 

SYNOPSIS 

sum file 

DESCRIPTION 

Sum calculates and prints a 16-bit checksum for the named file, and also prints the number of 
blocks in the file. It is typically used to look for bad spots, or to validate a file communicated 
over some transmission line. 

SEEALSO 

wc(l) 

DIAGNOSTICS 

'Read error’ is indistinguishable from end of file on most devices; check the block count'. 
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NAME 

sua - is current machine a sun workstation 
SYNOPSIS 

If aun} then .~t fl (»h) 


If { nun } then (e»h) 

••• 

•ndlf 

DESCRIPTION 

The sun command is, on Sun Workstations, the same as irue(I); on VAX’es and other machines it 
is the same as /afoe(l). 


SEE ALSO 

fal8e(l), true(l), vax(l) 


o 


o 
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NAME 

suntoob - the Suntools window environment 
SYNOPSIS 

[ netenv PATH ${PATH}s/u8r/8uiitool ] 

suntoob [ -n I -HI atart-up ^e] [ -di display devie^ ( — m mouse detnce] | -k keyboard dence] { -1 ] 
( -f red green blue] ( -b red green blue] ( -F | -B | --P 1 [ -p | 

GETTING STARTED 

Suntools starts up the Suntools window environment and awaits the user’s directions (often a 
menu action). If /dev has not been initialized for the window environment, suntools wUl fail; see 
Initialization below for detaib. If there is a file called .suntools in the user’s home directory, sun¬ 
tools starts the application programs {tools) specified in that file. The format of the .suntools file 
is described in detail below under Start-up Processing. 

The indications that the suntools system b ready are: 

1) the screen b painted with a solid color (usually light gray, see options), and 

2) an arrow-shaped cursor appears on the screen, tracking motions of the mouse. The mouse 
must be on its special pad before it can be tracked. Sometimes the cursor will not move 
at start-up; moving the mouse in large circles for a few seconds will bring the cursor to 
life. 

See Multiple/Color Displays for information about running suntools on more than one dbplay at 
the same time or on color displays. 

OPTIONS 

-n Start-up processing b bypassed by specifying this fiag. 
start-up file 

Specifies a file from which start-up commands are read. 

-d display device 

Specifies a dbplay device on which suntools b run. If thb option is not specified, the 
default frame buffer device, /dev/fb^ is used. 

-m mouse device 

Specifies a mouse device used by suntools as the system printing/locator device. If this 
option b not specified, the default mouse device, /dev/mouse, is used. 

-k keyboard device 

Specifies a keyboard device used by suntools as the ^stem keyboard. If thb option is not 
specified, the default keyboard device, /dev/khd, b used. 

—1 Invert the background and foreground colors used on the screen. On a monochrome mon¬ 
itor, thb option provides a video reversed image. On a color monitor, colors that are not 
used as the background and foreground are not affected. 

-f red green blue 

Specifies the values of the red, green and blue components of the foreground color. For 
most color screens, values must be between 0 and 255 where 0 b the absence of color and 
255 is the maximum intensity of that color. If this option b not specified, each com¬ 
ponent of the foreground color b 0 (black). 

-b red green blue 

Specifies the values of the red, green and blue components of the background color. If 
thb option b not specified, each component of the background color b 255 (white). See 
the —f option for more detaib. 

-F Use the foreground color for the suntools window color. 
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•-B Use^h^ background color for the euntooh window color. 

-P Uae a stipple pattern for the suntooh yvindovf color. If no -F, -B or *P option is given, 
-P is assumed. 

Display the name of the window device used for the auntooh window. 

DESCRIPTION 

Windows 

The auntooh window environment always has one window open which covers the whole screen; 
this is called the Root Window. A solid color is the only content of the Root Window; it serves as 
a backdrop for the auntooia environment. Tools that run in the environment are given their own 
windows which lie on top of portions of the Root Window (and possibly other tools). A window 
obscures those portions of other windows which lie below it; thus, only the topmost window is 
guaranteed to be fully visible, and the Root Window color shows through only in areas which 
have no tool windows on them. 

User Input to Windo ws 

User input actions (typing on the keyboard, moving the mouse, or pressing buttons on the mouse) 
are directed to the window which lies immediately under the cursor at the time they occur. User 
input actions are queued for each window, with mouse motions and button pushes integrated with 
keystrokes. It is perfectly reasonable to type some characters to one window, then move the 
mouse to another window, and type or use the mouse in it before the first window has processed 
its input; the type-ahead and mouae-akead are serialized and distributed correctly. 

The mouse buttons are usually interpreted as follows: the left button is used for selecting or 
choosing objects; the middle button is used to adjust selections to include more or fewer objects; 
and the right button is used to invoke menus. However, the exact interpretation of user actions 
depends on the window receiving them. For the standard tools available with the auntooia sys¬ 
tem, the tool’s input handling is described with the rest of its behavior in its specific section 
below. 

Menus 

Many functions in auntooia may be invoked by using the mouse and a pop-up menu. By conven¬ 
tion, pressing the menu (right) button on the mouse and holding it down calls up the menu(s) 
appropriate to the window containing the cursor. A menu is painted on the screen near the 
current location of the mouse, and the cursor is changed to a right-pointing arrow. The menu 
remains on the screen as long as the menu button is held down, and the pointer tracks the mouse. 
When the pointer enters a menu item, that item video-inverts, but nothing else happens while the 
menu button is kept down. Releasing the button while the pointer is in a menu item invokes that 
menu item: the menu is removed from the screen, and processing of that item begins. 

Multiple Menus 

Multiple menus are currently available only in the panetool. However, the following description 
applies to multiple menus in general. 

You may see more than one menu presented simultaneously; generally this occurs when several 
different classes of actions are possible in the current context. The menus are presented in a 
stack, with the label of each menu visible, and with the current menu on top so its items are also 
visible. To bring another menu to the top, thus making its items available, invoke its label as 
you would a menu item. That is, position the cursor in the label of the desired menu and release 
the menu button. Then press the menu button again, and the stack of menus is presented once 
more, but now with the selected menu on top. 
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An accelerator is provided for expert users to achieve the same result a little more quick^: when 
the cursor is positioned in the label of the desired menu, do not release the menu button; rather, 
while continuing to hold down the menu button, press and release the select (left) mouse button. 
The stack of menus is repainted with the selected menu on top, and menu operations may con* 
tinue. 


The Root Manager 

The Root Window ignores most keyboard input; any keystrokes generated while the cursor is over 
an exposed portion of the Root Window are simply discarded. However, four job«control func¬ 
tions are provided through the Root Window’s menu, which is presented when the menu button is 
depressed while the cursor is over an exposed portion of the Root Window. 

The items in the Root Manager menu are: 


New Shell Create a new Shell Tool. 

A new tool window is created on the screen, running a new copy of the shell. 
The window is placed on the screen on top of everything it overlaps. Its initial 
size can display 80 columns and 84 rows of characters. 

New Graphics Create a new Graphics Tool. 

A new tool window appropriate for running graphics programs is placed on the 
screen on top of everything it overlaps. 


Exit Exit the suntools program. 

All tool windows are closed, and their associated processes are killed. The user is 
returned to the shell which invoked suntools. This command requires 
confirmation: press the left mouse button to complete it; press the right button 
to cancel. 


ReDispIay All All the contents of the screen are redrawn. 

This can be used to repair damage done by processes that wrote to the screen 
without consulting the Suntools system (see the discussion of the Shell Tool for 
details on how to avoid this). 


The Tool Manager 

Tools interpret most user input in their own fashion; for instance, many tools incorporate a termi¬ 
nal emulator running a shell. However, tools are also expected to provide a small set of universal 
functions, through the Tool Manager menu. These functions are available when the cursor is over 
a portion of the tool which does not impose some other interpretation on the user input. For any 
tool, the black stripe at the top which holds the tool’s name, the border stripes of the window, 
and the whole of the tool’s icon are such areas. 

The items in this menu are: 

Close (or Open) Shrink the tool to a small image on the screen. 

Its process(es) continues to run. Closed windows are by default placed in the 
lower left of the screen, filling in rows to the right, and then bottom-to-top, in 
the order they are created. A closed window may be moved just like an open 
one; if it is reopened and closed again, it returns to its last closed position. 

When the Tool Manager Menu is brought up over a closed window, this item 
reads Open, and serves to reverse the process. When reopened, windows return 
to the position from which they were closed. 

Move Change the location of a window on the screen, without affecting its size or con¬ 

tents. 

When invoked, Move instructs the user to grasp the window by depressing and 
holding down either the left or middle mouse buttons, or to cancel the operation 
by pressing the right button; depressing any mouse button removes these 
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instructions from the screen. When either the left or middle button is depressed, 
the window is outlined by a box which tracks the mouse as long as that button 
is held down. The position of the pointer when the button is pressed determines 
how the window is moved: if it is near a corner, that comer of the box is 
attached to the mouse cursor. If it is in the middle third of a side, then the mid¬ 
point of the side of the box is attached to the mouse cursor. This box should be 
positioned where the window should go and the mouse button released; the win¬ 
dow is repainted in its new location, and its old location repaired. The level of 
the window (on top of or underneath others) is not affected. 

Stretch Change the size of a window on the screen. 

As with Move, instructions are posted for the user until a mouse button push 
either starts the Stretch or cancels it. The position of the pointer when either 
the left or middle button is pressed determines how the window is stretched: if it 
is near a corner, both of the sides that form that corner are adjusted; the oppo¬ 
site corner remains fixed. If it is in the middle third of a side, then only that 
side is adjusted; all 3 other sides remain fixed. The use of the bounding box, 
and behavior with respect to window level, is the same as for Move. 

Expose Bring the window to Hhe top of the heap’. 

The whole window becomes vbible, and occludes any window it happens to ovei^ 
lap on the screen. Its position on the screen does not change. 

Hide Put the window on the ’bottom of the heap’. 

The window is occluded by any window which overlaps it. Its position on the 
screen does not change. 

ReDispIay Redraw the contents of the window. 

Quit Notify the tool that it should terminate gracefully. 

Thb command requires the same type of confirmation as the Exit command in 
the Root Menu. 

In many multi-subwindow tools, the boundary between two subwindows may be adjusted up or 
down without changing the overall size of the tool. To do this, depress the middle mouse button 
over the boundary; a bounding box will be drawn for the subwindow above or to the left of the 
selected boundary. Now adjust the size of that subwindow, exactly as with the Stretch operation. 
When the button is released, that subwindow is adjusted to the size indicated, and the remaining 
area of the tool is allotted to the other subwindows. 

Tool Management Aceeleratore 

Accelerators are provided for some of the Tool Manager functions, allowing experienced users to 
invoke these functions more quickly: these functions can be invoked with a simple button push in 
the tool window. 

The accelerators for the various functions are: 

Open A closed (iconic) tool may be opened by clicking the select (left) mouse button 

while the cursor is over the icon. 

Move The Move operation may be invoked by depressing the middle mouse button 

while the cursor is in the tool window’s name stripe or outer boundary; a bound¬ 
ing box is displayed and tracks the mouse as long as the middle button is held 
down; the window is placed in the position indicated by that box when the but¬ 
ton is released. 

Expose Clicking the left mouse button at an open tool window exposes that window. 

Help Typing a question mark to a tool window will cause a help message to be 

displayed on the screen, explaining the material covered here. 
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Terminal Emulators and Selections 

Several tools provide a terminal emulator in some part of their window, running a shell. Keys¬ 
trokes typed to this eubwindow are passed through to the program runnmg in it, rather than being 
handled by the tool. (This means these tools provide Tool Manager functions only when the cur¬ 
sor is in their name stripe or borders.) Similarly, output from the programs is displayed in the 
window. 

Terminal subwindows support a facility called a selection, which provides for limited inter-tool 
communication and mouse-oriented text manipulation. A selection is a span of characters which 
you may wish to manipulate. The mouse is used to make a selection: 

• Click the select (left) mouse button while the tip of the cursor is over a character, and that 
character is selected. Any previously selected characters are de-selected. A box is drawn 
around selected characters to indicate their status. 

• Click the adjust (middle) mouse button to change the span of chs^acters that are selected: all 
characters from the one originally selected through the one over which adjust is pressed are 
selected. Characters which used to be selected, but which do not lie in the span just 
described, are de-selected. The box which indicates the selection is adjusted to reflect its new 
contents. 

Only characters which are displayed in a terminal subwindow may be selected. Characters which 
are in a portion of the window obscured by another window will be selected if they Ue within a 
span of characters whose endpoints are selected. 

The user feedback (the boxed characters) indicating the selection is removed if: 

• the cursor moves out of the subwindow which holds the selection, 

• any key is typed, or 

• any new output is written to the window which holds the selection. 

However, even if the feedback is removed, it is important to note that the selection still exists and 
can be operated upon until the point in time that another selection is explicitly made by the user. 
The fact that the feedback is removed in these circumstances reflects an incomplete selection 
implementation. 

The selection is manipulated via the Selection menu provided by the terminal subwindow. There 
is a single menu item: 

Stuff The characters in the selection, are copied to the window as though they had been typed 
at the keyboard. The window in which Stuff is invoked does not have to be the same as 
the one in which the selection was made; thus text may be copied between windows by 
this facility. 

The selection mechanism is not integrated with the terminsd emulator. However, it is useful for 
building up complex command sequences and helps aivoid repetitive keyboard input. Selection 
facilities will be expanded in future releases. 


Other Aspects of Termlnsd Emulators 

Existing tools with terminal emulator subwindows pass command line arguments to the terminal 
emulator. The terminal emulator then passes a command line to the program it starts. No argu¬ 
ments indicate that the program described by the user’s SHELL environment value is run by the 
terminal emulator. If this program is not available then Jhinfsh is run. If there are arguments, 
the program named by the first one is run. However, if the first argument is -c a shell is run 
which in turn runs the command line named by the argument following the -c. See Start-up Pro¬ 
cessing below for an example. 
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The SheU Thol 

The Shell Tool is one of the standard tools provided with the euntoola environment. It consists of 
a terminal subwindow, in which a shell is started. Because keystrokes are passed to the shell, or 
the programs run from it, and the mouse is used to support selections, the Tool Manager is not 
accessible from the terminal subwindow of the Shell Tool. Tool Manager functions may be 
accessed in the tool’s name stripe and borders. 

Programs that are run in the Shell Tool are generally for character-oriented terminals. Graphics 
Programs (see below) will run in the Shell Tool, but may exhibit minor glitches. Graphics Pro¬ 
grams should be run in the Graphics Tool (see below). 

The size of the SheU Tool’s virtual terminal (in lines and columns) is adjusted to reflect the 
dimensions of the window as they change. Thus, programs like emaca, more, and vi, which 
inquire the characteristics of the terminal they run on, adjust to differently-sized windows 
automatically. Since they only inquire as they start up, however, they do not reflect changes to 
window dimensions that occur after they are started; such changes may result in a confusing 
display for that program. 

One important feature of a SheU Tool is that it may be used as a substitute for the standard con¬ 
sole. Unless instructed otherwise, the system displays messages for the console by writing directly 
on the bitmap display, bypassing all of the support for multiple windows sharing the bitmap; 
thus, console messages damage the window images. It is possible to redirect console messages into 
a terminal subwindow by starting a SheU Tool with a flrst argument of console, which causes all 
messages destined for the console to appear inside this shell’s window. An example appears under 
Start-up Proeeaaing below. 

Tha Graphics Tool 

The Graphics Tool is a second tool provided with auntoota. It has two subwindows: a terminal 
subwindow in which a shell is started, just as for the Shell Tool, and a graphics area which may 
be drawn on by programs invoked from that shell. The boundary between these two subwindows 
may be moved as described in The Toot Manager above. The graphics area normally acts as part 
of the tool window for user input; that is, it provides Tool Manager functions to mouse and key¬ 
board events. Some graphics programs run in this window may take over inputs directed to it; 
SunCore is an example, since it uses the mouse and keyboard for its own input. While this is 
true. Tool Manager functions are accessible only in the namestripe and borders, as with the Shell 
Tool. When the program which has taken the input terminates, the window is restored to its ori¬ 
ginal status. 

Demos which draw pictures should be run in the Graphics Tool; the four distributed with the 
current release of auntoota are: 

/usr/suntool/bouncedemo 

Displays a bouncing square in the gr^hics window. A decimal number on the command 
line indicates how many repetitions of the bounce sequence should be done. 

/usr/suntool/spheresdemo 

Laboriously computes a random collection of shaded spheres. A -n followed by a decimal 
number on the command line indicates how many spheres should be drawn. Colored 
spheres are drawn on color displays. 

/usr/suntool/jumpdemo 

Simulates the famous Star Ware jump to light-speed sequence using vector drawing. A 
-n followed by a decimal number on the command line indicates how many stars should 
be used in the star field, up to 500. Colored stars are drawn on color displays. A -e on 
the command line directs the program to rotate the color map, thus producing a sparkling 
affect. 
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/ asr/suntool/framedemo 

Displays a series of frames, each of which contains a 256 by 256 image formed of pixels 
one deep (that is, the image is a square monochrome bitmap, with 256 bits on a side). 
The frames must be in the files fratneJ through Jramt.n on the current working directory, 
and are displayed in numerical order. A set of sample frames is available on the directory 
fuer/euntool/globeframee. A -n followed by a decimal number on the command line indi¬ 
cates how many times to cycle through the frames. If the cursor is moved into the image 
window, typing certain characters affects the rate at which the frames are displayed: the 
initial rate is one frame per second; each "S’* causes an additional one second delay 
between frames; each “P” removes one second from the inter-frame delay; each “s” adds 
l/20th of a second; each “f ’ removes l/20th of a second. 

For all these demos the following is true: if no -n flag appears on the command line then the pro¬ 
gram runs continuously until interrupted by the user. A -r flag on the command line turns the 
window into a retained window which allows the image to reappear when uncovered instead of 
restarting the demo. These demos can all be invoked from the workstation console, i.e., outside 
of the euntoole window environment. Also, a -d flag followed by a display device name can direct 
the demo to run on a display other than the console, “bouncedemo -d /dev/cgoneO”. 

The Icon Tool 

The Icon Tool is a simple bitmap editor, useful for constructing small images such as cursors and 
icons. It has four subwindows: 

• At the top, a one-line ‘text window’ displays error and warning messages. 

• Below that on the left, a small ‘proof window’ for checking the image as it Is drawn, 

• To the right of the ‘proof window’, a ‘control panel’ (an options subwindow, as described in 
chapter 7 of the Programmer’s Reference Manual for SunWindows, and 

• Below those two, filling most of the area of the tool, a large canvas on which to draw the 
image. 

Painting 

The canvas displays magnified pixels in a square either 16 or 64 on a side. The larger 
magnification (fewer pixels) is appropriate for cursors, the smaller, for icons. The left mouse but¬ 
ton is used to darken (paint) pixels on the canvas, the middle button to clear (erase) them. A 
button may be held down and the cursor ‘wiped’ through several pixels. The state of the mouse 
buttons is lost if the cursor leaves the window; the button must be pressed after the cursor is in 
the window, and it must be released and pressed again if the cursor strays out of the window’s 
boundary. 

The right (menu) button has no special significance to the icontool, so it invokes the standard 
tool-manager menu. 


Program Control 

The control panel presents a number of items; , the interesting ones are either parameters or com¬ 
mands. Each is identified by a label displayed in bold face. Commands are like function keys 
that can be ‘pushed’ with the mouse — clicking a mouse button over one of them causes some 
action to take place. They are displayed surrounded by parentheses. Parameters are either 
choices or text items. Choices are used to select one of a set of mutually exclusive possibilities; 
the set of possibilities is displayed inside braces, and the current value is displayed in reverse 
video. Text items have a label ending with a colon, followed by the string which is the value of 
that item. A very long value may not be completely displayed; characters out of sight at the end 
are nonetheless part of the value. The text item which is currently accepting keystrokes has a 
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box around jts label. Since the icontool has only one text item, its label is always boxed. 

In general, either the left or middle button may be used to manipulate an item in the control 
panel. Items give feedback (usually by inverting) when the cursor is over them with a button 
down to show what will happen if the button is released at that point. But they do not take any 
action until the button is released. You can slide the cursor around over many items until you 
have the one you want. As long as you don’t release the button, you can cancel any action by 
simply moving the cursor into empty space before releasing the button. 

As with the canvas window, the state of the mouse buttons is lost when the cursor crosses a win* 
dow boundary; the button must be pressed after the cursor is in the options subwindow. 

The particular parameters and commands are discussed in the order they appear: 

Draw a: { Cursor Icon } 

Controls the size of the image the tool is working on. A cursor is 16 pixels square; and 
icon is 64 square. When the image type is changed, the old image is preserved, and 
restored if the type is later changed back. This parameter will also be set by the Load 
File command (see below), according to the size of the object loaded. 

Left Paints, Middle Erases 

This is a simple label which does not react to user actions. 

(Quit) Requests confirmation from the user, and if it is given, terminates the tool’s processing. 
Confirm the termination by clicking the left mouse button; if you decide you don’t want 
to quit yet, click the right or middle button. 

(Load) 

(Store) Allow the tool to deal with images stored as files on disk. They each use the text in the 
“File” parameter as the name of a file to be processed. The format of the file is an ini* 
tialized C*laoguage array of shorts or ints, with the initializers expressed in hex. (Actu* 
ally, the Load routine only cares about finding the correct number of hex numbers 
separated by commas and surrounded by braces.) 

Load reads the named file, determines its size by how many numbers it reads, sets the 
“Draw a” mode accordingly, and then either merges the current image of that size with 
bits it read, or replaces it, according to the “Load / Fill should: { Replace Merge }” 
parameter described below. 

“Store” writes the current image into a file with the indicated name. If such a file 
already exists, “Store” asks for confirmation before over*writing it. Either routine com¬ 
plains about other anomalous conditions, such as reading a non-existent file, or violating 
file permissions. Write to a directory with write permissions . . . not lu$r/tuntool$. 

File: A text parameter used by “Load” and “Store” commands as described above. Any 

(printable) characters typed at the keyboard while the cursor is in the option subwindow 
are appended to this parameter. The user’s erase and kill characters may be used to 
delete the last character and the whole text, respectively. There is no need to enter an 
“insert” command or to finish the name with a Carriage Return, Escape, or other termi¬ 
nator; “Load” and “Store” always use the text currently available. (Non-printing char¬ 
acters such asCR or TAB don’t do any harm either; they are simply discarded.) 

(Fill) Causes a constant pattern (selected by the following choice) to be written into the current 
image, either replacing or adding to its current contents. 

with { White 25% Root Gray 50% 75% Black } 

Governs the source for “Fill”. The second through fifth values are grays of various shades 
and patterns; Root Gray is the pattern used for Suntools’ Root Window. Try filling a 
cursor canvas to see what they’re like. 

Invert Causes all the pixels in the current image to be inverted. 
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Load / Fill should { Replace Merge } 

Governs the operation used by “Load" and “FUr’; if it is Replace, the new image 
replaces the old one; if it is Merge, they are ORed together. 

Cursor Op 

Only appears when you are drawing a cursor. In this case, the cursor that tracks the 
mouse while it is in the Proof window Is the one yon have drawn, and this choice controls 
the raster operation used to display it there. 

Proof background { White 25% Root Gray 50% 75% Black } 

Controls the background pattern in the Proof window against which a cursor or icon will 
be displayed. The choices are the same as for “FiH’s" source. 

Feedback 

In icon mode, the Proof window in the upper left comer presents the current image at its 
true size on a background chosen by the Proof background option. In cursor mode, the 
whole proof window is filled with the background pattern, and the cursor in the proof 
window refiects the current image. 

The Clock Tool 

The Clock Tool is a simple tool to display the current time. It must be started from a shell, or an 
entry made for it in your start>up file, since it does not appear in the Root Manager menu. Type 
elocktool Sl to any shell running in a window; the ampersand allows the shell to process other 
commands while the clock is running. While it is open, the Clock Tool prints the date and time 
in its window; when it is closed, its icon is a clock face which keeps time. The Clock Tool’s win¬ 
dow is not a terminal subwindow; it provides the Tool Manager menu if the menu button is 
depressed over it. However, it listens for keyboard input, toggling its state on two letters (case 
does not matter): 

s toggles the display of seconds. The clock starts with seconds turned off, and updates every 
minute. With seconds turned on, it updates every second, and, if iconic, displays a second 
hand. 

t toggles the ‘test’ mrode. The clock starts with testing off. With testing on, the clock ignores 
the real time, and instead runs in a loop continuously incrementing the time by one minute 
and displaying it. 

These states may only be modified while the clock is open; when it is iconic, it responds with the 
standard Tool Manager functions to mouse and keyboard input. 

The Pane Tool 

The Pane Tool is a sample tool to demonstrate a random collections of features not used by other 
tools: 

• There are four subwindows that tile the tool surface. The boundaries between the subwindow 
can be moved as described above. 

• Keyboard input directed at the upper right subwindow is redirected to the upper left subwin¬ 
dow. 

• Keyboard input directed at the upper left subwindow demonstrates raw unencoded up/down 
keyboard codes. 

• The lower left subwindow cycles through alternating menu stacks each time the menu button 
is depressed. 
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8tart*up Prdcesslngt The '^untools* File 

SuntooU can set up a standard arrangement of windows for the user when it starts up. It does 
this by reading the tie .suntoola in the user’s home directory, and following the instructions there. 
A file name on the command line indicates an alternative file to be read. A -n switch suppresses 
start-up processing. 

Each line in the file indicates data for one tool to be started. A line has the format: 
path nl nt nw nh U it iw ih I arg$ 

where path is the file name of the tool to be run, nl, nt, nw, and nh are decimal numbers which 
define the window for the normal (open) tool, as left edge, top edge, width, and height; il, it, iw, 
and ih are the same for the iconic form of the tool; and / is a boolean flag which should be non- 
sero if the tool is to be started in its tcome form. The remainder of the line (arga) is passed to 
the program running in the window as command-line arguments. The origin (0, 0) is the upper 
left hand corner of the screen. If a site parameter is equal to -1 then the Root Manager assigns 
an appropriate value. 

For example, consider a .auntoola file containing: 

shelltool 0 72 -1 728 4 4 64 64 0 -c “vi "/sked” 

sheUtool 372 0 -1 792 -1 -1 64 64 0 CONSOLE 

clocktool 4 4 180 40 232 4 64 64 1 

This starts auntoola with three tools active: 

• A Shell Tool in a window 38 by 80 characters, pushed into the lower left comer of the screen, 
leaving enough space above it to St some icons, and running the editor vi on a file named 
‘sked’ in the user’s home directory. The string *vi ~/sked’ is passed as a command to be exe¬ 
cuted by the sheU which runs in the tool. The icon is placed in the upper left corner of the 
screen. 

• Another Shell Tool, extending nearly the full height of the screen (48 lines), and batted 
against the right edge. Its icon is placed by the system, and the shell waits for user typein; this 
shell’s window will display sdl messages directed to the console. 

• A Clock Tool starts out iconic, about a quarter of the way across the top of the screen. 

The program toolplaeea in the directory fuarfauntool can be helpful in constructing the .auntoola 
file; it writes (on the standard output) a description of the windows that exist at the time it is 
run. 

Chnaging th« System Font 

The system has a default font built into it. It is possible to use another font instead by setting 
the environment variable DEFAULTJPONT to the name of the file containing the font to use. 
DEFAULT_FONT must have been set in the shell from which the program was invoked. A small 
number of valid alternative fonts can be found in the directory fuarfauntool/fixedwidthfonta. 

Multiple/Color Displays 

The auntoola program runs on either a monochrome or color screen. Each screen on a machine 
may have its own invocation of auntoola running on it. The keyboard and mouse input devices 
are shared among multiple screens. The mouse cursor slides from one screen to another when the 
user moves the cursor off the edge of a screen. All the screens (frame buffers) supported by Sun 
Microsystems are supported. 

A common configuration would be two screens, a monochrome and a color screen. Here is how a 
user could set up an instance of auntoola on each screen. 

1) Invoke suntools on the monochrome display by running “suntools”. This starts auntoola 
on the default frame buffer named Idevlfb. 
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2) In a Shelltool, run "suntools -d /dev/cgoneO". This starts iuntooh on a Sun-1 color 
screen. 

3) In a Shelltooi on the monochrome screen, run “adjacentscreens /dev/fb -r /dev/cgoneO”. 
This sets up cursor tracking so that the cursor slides from the monochrome screen to the 
color screen when the cursor moves off the right hand side of the monochrome screen. 
Similarly, the cursor slides from the color screen to the monochrome screen when the cur¬ 
sor moves off the left hand side of the color screen. 

Getting Out 

Any tool may be exited by invoking the Quit command in the Tool Manager menu while over the 
tool’s window, as described above. Tools which run a shell (the Shell Tool and Graphics tool) also 
go away if that shell ever exits, so typing 'D to the shell in a terminal subwindow also makes the 
tool go away. Exit the whole window system by invoking the ‘Exit’ menu item in the Root 
Manager menu, and confirming that that’s what you meant when the system inquires. It is wise 
to ensure that all windows are in a safe condition (for example, editors have written out all 
changes) first. 

Suntoolf may also be exited via the keyboard by typing ‘D followed by *Q. There is no 
confirmation. This facility provides an escape hatch if the user inadvertently starts tuntooU when 
no mouse is attached to the system. 

Inltlallcation 

Before tuntooh can be run, appropriate devices must be created for it in the /dev directory. This 
need only be done once on each machine. If this has not yet been done, 

• set your user id to root, 

• change directory to /dev, and 

• execute the shell script ‘MAKEDEV winO*. 

Suntooto also needs the file /ete/utmp to have read and write permission for all users. It should 
have been installed with these permissions, but if not, you need to use ehmod to change the per¬ 
missions. 

SEE ALSO 

Other programs that run in the Suntools environment: loek8ereen(l), per/jnon{l), and adja- 
cent9creen9{l). 

FILES 

/usr/suntool/suntools 

‘/.suntools 

/ usr/suntool/fixedwidthfonts/* 

/usr/suntool/clocktool 
/usr/suntool/gfxtool 
/usr/suntool/panetool 
/usr/suntool/shelltool 
/usr/suntool/icontool 
/ usr/suntool/bouncedemo 
/usr/suntool /framedemo 
/usr/suntool/globeframes/* 

/usr/suntool/jumpdemo 
/ usr/suntool/spheresdemo 
/usr/suntool/toolplaces 
/etc/utmp 
/dev/win* 

/dev/ptyp* 
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/dev/t^p» 

/dev/fb 

/dev/kbd 

/dev/mou8e 

/dev/MAKEDEV 

BUGS 

This release has the following notable bags: 

(1) Messages from the kernel ignore window boundaries unless console messages have been 
redirected, thus trashing the display. Recover from this by invoking the 'ReDisplay All* 
item on the Root Manager menu. 

(2) Remote login to another machine should be done with a your terminal emulator subwin- 
dow matching the standard terminal sice for the remote machine (for example, 34 by 80 
character for a Sun workstation) The remote machine does not understand terminals with 
non-standard sise. 

(3) Acceptable performance on realistic tasks (for example editing with vi while running a C 
compile with make) requires about OOOK of available user memory. With 1.1 Unix, the 
kernel may have to be reconfigured to make that space available. See the System 
Managers Guide. 
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NAME 

sync - update the super block 

SYNOPSIS 

syne 

DESCRIPTION 

Syne executes the tyne system primitive. Syne can be called to ensure all disk writes have been 
completed before the processor is halted in a way not suitably done by re(oof(8) or haU(8). 

See »yne{2) for details on the system primitive. 

SEE ALSO 

sync(2), fsync(2), halt(8), reboot(8), cron(8) 
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NAME 

syslog - make system log entry 
SYNOPSIS 

■yilog ( -P ] (**1 name ] | -tevet ] (— ] [ meaaage ... ] 

DESCRIPTION 

Syalog sends the specified message (or atdin if — is specified) as a system log entry to the syslog 
daemon. The log entry is sent to the daemon on the machine specified by the loghoat entry in the 
I etcfhoata file. 

OPTIONS 

-p Syalog will log its process id in addition to the other information. 

-1 name 

The specified name will be used as the “ident" for the log entry. 

-level The message will be logged at the specified level. The level can be specified numerical^, 
in the range 1 through 9, or symbolically using the names specified in the include file 
/usr/include/syslog.h (with the leading LOG. stripped off), “ayalog -HELP” will list the 
valid symbolic level names. Only the superuser can make log entries at levels less than or 
equal to SALERT. 

- Each line of the standard input is sent as a log entry. 

FILES ' 

/usr/etc/in.syslog syslog daemon 
/usr/include/syslog.h for names of logging levels 

SEE ALSO 

sy8log(3), syslog(8) 
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NAME 

tail - dbplay the la^t part of a file 
SYNOPSIS 

tall ( ± numier[lbel[fr]] [ file | 

DESCRIPTION 

Tail copies the named file to the standard output beginning at a designated place. If no file is 
named, the standard input is used. 

OPTIONS 

Options are all jammed together, not specified separately with their own - signs. 

4'num6er 

Begin copying at distance + number from the beginning of the file. Number is counted in 
. units of lines, blocks or characters, according to the appended option 1, b, or e. When no 
units are specified, counting is by lines. 

—number 

Begin copying at distance -number from the end of the file. Number is counted in units 
of lines, blocks or characters, according to the appended option 1, b, or e. When no units 
are specified, counting is by lines. 

r Copy lines from the end of the file in reverse order. The default for r is to print the 
entire file this way. 

f Follow the file as it grows, that is, don’t quit at end of file, but rather wait and try to 
read repeatedly in hopes that the file will grow. 

SEE ALSO 
dd(l) 

BUGS 

Tails relative to the end of the file are treasured up in a buffer, and thus are limited in length. 
Various kinds of anomalous behavior may happen with character special files. 
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NAME 

talk - talk to another user 
SYNOPSIS 

talk person I ttyname ] 

DESCRIPTION 

Talk is a visual communication program which copies lines from your terminal to that of another 
user. 

If you wish to talk to someone on your own machine, then person is just the person’s login name. 
If you wish to talk to a user on another host, then person is of the form : 
hoetluaer or 
hoaUuttr or 
hoattuser or 
userOhosi 

though uaerQhoat is perhaps preferred. 

If you want to talk to a user who is logged in more than once, the ttyname argument may be used 
to indicate the appropriate terminal name. 

When first called, talk sends the message: 

Message from TalkDaemonOhis.machine... 
talk: connection requested by your_nameQyourjmachine. 
talk: respond with: talk your_nameQyour_macbine 
to the user you wish to talk to. At this point, the recipient of the message should reply by typ¬ 
ing: 

tutorial^ talk your_nameQyoar_macliin« 

It doesn’t matter from which machine the recipient replies, as long as their login-name is the 
same. Once communication is established, the two parties may type simultaneously, with their 
output appearing in separate windows. Typing control-L redraws the screen, while your erase, 
kill, and word kill characters will work in talk as normal. To exit, just type your interrupt char¬ 
acter; talk then moves the cursor to the bottom of the screen and restores the terminal. 

Permission to talk may be denied or granted by use of the merp(l) command. At the outset talk¬ 
ing is allowed. Certain commands, in particular nrs^l) and pr(l) disallow messages in order to 
prevent messy output. 

FILES 

/etc/hosts to find the recipient’s machine 

/etc/utmp to find the recipient’s tty 

SEE ALSO 

mesg(l), who(l), mail(l), write(l) 
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NAME 

tar ~ tape archiver 

SYNOPSIS 

tmr —txruc[ovwfblmhpBO-OI] [ tarfile ] [ blocksize ] filel file2 ... —C dir filen ... 

DESCRIPTION 

Tar saves and restores multiple files on a single tarfile (usually a magnetic tape, but it can be any 
file). Tar’s actions are controlled by its first argument, the key, a string of characters containing 
exactly one function letter from the set rxtue and one or more optional function modifiers. 
Other arguments to (ar are file or directory names specifying which files to dump or restore. In 
all cases, appearance of a directory name refers to the files and (recursively) subdirectories of that 
directory. 

FUNCTION LETTERS 

r Write the named files on the end of the tarfile. Note that this option does not work with 
quarter-inch archive tapes. 

X Extract the named files from the tarfile. If the named file matches a directory whose contents 
had been written onto the tape, this directory is (recursively) extracted. The owner, 
modification time, and mode are restored (if possible). If no file argument is given, the entire 
content of the tape is extracted. Note that if multiple entries specifying the same file are on 
the tape, the last one overwrites all earlier versions. 

t List the names of the specified files each time they occur on the tarfile. If no file argument is 
given, all of the names on the tarfile are listed. 

u Add the named files to the tarfile if they are not there or have been modified since last put on 
the tarfile. Note that this option does not work with quarter-inch archive tapes. 

c Create a new tarfile and write the named files onto it. 

FUNCTION MODIFIERS 

Select an alternate drive on which the tape is mounted. The default is drive 0 at 1600 bpi, 
which is normally fdevfrmtS, 

t Use the next argument as the name of the archive instead of fdevIrmtS, If the name of the 
file is tar writes to standard output or reads from standard input, whichever is appropriate. 
Thus, tar can be used as the head or tail of a filter chain. Tar can also be used to copy hierar¬ 
chies with the command: 

tutorial% ed fromdiri tar cf - • | (cd todiri tar xf^ -) 

o Suppress information specifying owner and modes of directories which tar normally places in 
the archive. Such information makes former versions of tar generate an error message like: 

‘<name>/: cannot create’ 
when they encounter it. 

V Normally tar does its work silently; the v (verbose) option displays the name of each file tar 
treats, preceded by the function letter. When used with the t function, v displays the tarfile 
entries in a form similar to b -I. 

w Wait for user confirmation before taking the specified action. If you use w, tar displays the 
action to be taken followed by the file name, and then waits for a ‘y’ response to proceed. No 
action is taken on the named file if you type anything other than a line beginning with *y’. 

b Use the next argument as the blocking factor for tape records. The default blocking factor is 
20 blocks. The block size is determined automatically when reading tapes (key letters x and 
t). This determination of the blocking factor may be fooled when reading from a pipe or a 
socket (see the B key letter below). The maximum blocking factor is determined only by the 
amount of memory available to the program at the time it runs. Larger blocking factors 
result in better throughput, longer blocks on nine-track tapes, and better media utilization. 
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1 Display error messages if all links to dumped files cannot be resolved. If 1 is not used, no error 
messages are printed. 

m Do not restore modification times of extracted files. The modification time will be the time of 
extraction. 

h Follow symbolic links as if they were normal files or directories. Normally, tw does not follow 
symbolic links. 

p Restore the named files to their original modes, ignoring the present umask(2). Setuid and 
sticky information are also restored if you are the super-user. This option is only useful with 
the X key letter. 

B Force tar to perform multiple reads (if necessary) so as to read exactly enough bytes to fill a 
block. This option exists so that tar can work across the Ethernet, since pipes and sockets 
return partial blocks even when more data is coming. 

1 Ignore directory checksum errors. 

If a file name is preceded by -C in a e (create) or r (replace) operation, tar will perform a 
ehiir{2) to that file name. This allows multiple directories not related by a close common parent 
to be archived using short relative path names. For example, to archive files from futrlinclude 
and from J etc, one might use: 

tutorial^ tar e -C /usr Include -C /etc . 

If you get a table of contents from the resulting tarfSe, you wOI see something like: 
include/ 
inelude/a.out,b 

and all the other JUea in futrf include 
•/ 

./chown 

and aU the other flleo in fete 

Note that the -O option onl^ applies to one following directory name and one following file 
name. 

EXAMPLES 

Here is a simple example using tar to create an archive of your home directory onto fdev/rmtO: 
tutorial^ ed poeition youreelf in your home directory 

tutorial^ tar evf /dev/rmtO t create the archive 

loto of meooageo from tar 

tutorial^ 

The e option means create the archive; the v option makes tar tell you what it’s doing as it 
works; the f option means that you are specifically naming the file onto which the archive should 
be placed {fdevfrnUO in this example). 

Now you can read the table of contents from the archive like this: 

tutorial^ tair tvf /dev/rmtO display table of contents of the archive 

loto of messages from tar 

tutorial^ 

Where the t option is for displaying the table-of-contents of the archive. You can extract files 
from the archive like this; 

tutorial^ tar xvf /dev/rmtO extract files from the archive 

lotp of messages from tar 

tutorial^ 

Where the x option is for extracting files from the archive. 
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Here is a note to clarify the effects of using lar to read from tapes where there are multiple 
archive files on the same tape. If there are multiple archive files on a tape, each is separated from 
the following one by an end-of-file marker. Tar does not read the end*of>file mark on the tape 
after it finishes reading an archive file because tar looks for a special header to decide when it has 
reached the end of the archive. Now if you try to use tar to read the next archive file from the 
tape, tar doesn’t know enough to skip over the end>of*file mark and tries to read the end-of-file 
mark as an archive instead. The result of this is an error message from tar to the effect: 
tar: blocksize=0 

This means that to read another archive from the tape, the user must skip over the end-of>fiIe 
marker before starting another tar command. You can achieve this via the mt command, as 
shown in the example below. Assume that you are reading from fdev/nrmtO. 
tutorial^ inr xvfk> /dev/nrmtO read firet archive from tape 
tote of meeeagee from tar 

tutorial% mt fsf 1 eUp over the end-of-file marker 
tutorial% tar xvfk> /dev/nrmtO read eeeond archive from tape 
tote of meeeagee from tar 

tutoriaI% 

Finally, here is a note on using tar to transfer files across the Ethernet. First, here is how to 
dump files from the local machine (tutorial) to a tape on a remote system (krypton): 

tutorial% tar evfb - 20 filee \ rsb krypton dd ofa/dev/rmtO obnssSOb 
lote of meeeagee from tar 

tutorial^ 

In the example above, we are creating a tarfile with the e key letter, asking for verboee output 
from tar with the v option, specifying the name of the output tarfile via the f option (the stan* 
dard output is where the tarfile appears, as indicated by the - sign), and specifying the blocksize 
(20) with the b option. If you want to change the blocksize, you must change the blocksize argu> 
ments both on the tar command and on the dd command. 

Now, here is how to use tar to get files from a tape on the remote system (krypton) back to the 
local system (tutorial): 

tutorial% rab krypton dd Ifa/dey/rmtO bassffOb | tar xvBfb - SO filee 
lote of meeeagee from tar 

tutorial% 

In the example above, we are extracting from the tarfile with the x key letter, asking for verboee 
output from tar with the v option, specifying the name of the input tarfile via the f option (the 
standard input is where the tarfile appears, as indicated by the - sign), and specifying the block- 
size (20) with the b option. 

FILES 

/dev/rmtT half-inch magnetic tape interface 
/dev/rarT quarter-inch magnetic tape interface 
/dev/rstT SCSI tape interface 
/tmp/tar* 

SEE ALSO 

tar(5), cpio(l), dump(8), restore(8) 

DIAGNOSTICS 

Complains about bad key characters and tape read/write errors. 

Complains if enough memory is not available to hold the link tables. 

BUGS 

Neither the r option nor the u option can be used with quarter-inch archive tapes, since these 
tape drives cannot backspace. 
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There is no way to ask for the n>th occurrence of a file. 
Tape errors are handled ungracefuUy. 

The tt option can be slow. 

There is no way to selectively follow symbolic links. 
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NAME 

tbi - format tables for nrofif or troff 
SYNOPSIS 

tbl (-ms ] ( —mm ] ( files ] ... 

DESCRIPTION 

Tbl is a preprocessor for formatting tables for nr off at troff{l). The input files are copied to the 
standard output, except that lines between .TS and .TB command lines are assumed to describe 
tables and are reformatted. Details are given in the tbl(l) reference manual. 

If no arguments are given, tbl reads the standard input, so tbl may be used as a filter. When tbl is 
used with eqn or neqn the tbl command should be first, to minimize the volume of data passed 
# through pipes. 

OPTIONS 

-ms Copy the -ms macro package to the front of the output file. 

-mm Copy the -mm macro package to the front of the output file. 

EXAMPLE 

As an example, letting \t represent a tab (which should be typed as a genuine tab) the input 

.TS 

css 

CCS 

c c c 
1 n n. 

Household Population 

Town\tHouseholds 

\tNumber\tSize 

Bedmin8ter\t789\t3.26 

Bernards Twp.\t3087\t3.74 

Bernardsville\t2018\t3.30 

Bound Brook\t3425\t3.04 

Branchburg\tl844\t3.49 

Bridgewater\t7897\t3.81 

Far Hills\t240\t3.19 

.TE 

yields 




Household Population 
Town Households 



Number 

Size 

Bedminster 

789 

3.26 

Bernards Twp. 

3087 

3.74 

Bernardsville 

2018 

3.30 

Bound Brook 

3425 

3.04 

Branchburg 

1644 

3.49 

Bridgewater 

7897 

3.81 

Far Hills 

240 

3.19 


SEE ALSO 

trofr(l), eqn(l) 

Formatting Tables toith tbl in 

Editing and Text Processing on the Sun Workstation. 
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NAME 

tee - copy standard output to many flies 
SYNOPSIS 

tee(-l] [-a] [flle]... 

DESCRIPTION 

Ttt transcribes the standard input to the standard output and makes copies in the fUtt. 
OPTIONS 

-1 Ignore interrupts. 

-a Append the output to the file$ rather than overwriting them. 
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NAME 

telnet - user interface to the TELNE2T protocol 

SYNOPSIS 

telnet ( host { port ] | 

DESCRIPTION 

Telnet communicates with another host using the TELNET protocol. If telnet is invoked without 
arguments^ it enters command mode, indicated by its prompt (“telnet>”). In this mode, it 
accepts and executes the commands listed below. If it is invoked with arguments, it performs an 
open command (see below) with those arguments. 

Once a connection has been opened, telnet enters input mode. In this mode, text typed is sent to 
the remote host. To issue telnet commands when in input mode, precede them with the telnet 
“escape character" (initially “']"). When in command mode, the normal terminal editing con* 
ventions are available. 

TELNET COMMANDS 

The following commands are available. Only enough of each command to uniquely identify it 
need be typed. 

open hoot ( port ] 

Open a connection to the named host. If the no port number is specified, telnet will 
attempt to contact a TELNET server at the default port. The host specification may be 
either a host name (see ho8te{5)) or an Internet address specified in the “dot notation”. 

clone Close a TELNET session and return to command mode. 

quit Close any open TELNET session and exit telnet. 

H Suspend telnet. This command only works when the user is using the ceh(l). 
escape [ escape-ckar] 

Set the telnet “escape character". Control characters may be specified as followed by 
a single letter; e.g. “control-X" is “*X”. 

status Show the current status of telnet. This includes the peer one is connected to, as well as 
the state of debugging. 

options 

Toggle viewing of TELNET options processing. When options viewing is enabled, all TEL¬ 
NET option negotiations will be displayed. Options sent by telnet are displayed as 
“SENT”, while options received from the TEILNET server are displayed as “RClhj”. 

crmod Toggle carriage return mode. When this mode is enabled any carriage return characters 
received from the remote host wUI be mapped into a carriage return and a line feed. This 
mode does not affect those characters typed by the user, only those received. This mode 
is not very useful, but is required for some hosts that like to ask the user to do local echo¬ 
ing. 

f [ command ] 

Get help. With no arguments, telnet prints a help summary. If a command is specified, 
telnet will print the help information available about the command only. 

SEE ALSO 

rlogin(lC) 

BUGS 

There is no provision in the standard TELNET protocol to support ‘S/"Q type commands. This 
implementation is very simple because rlogin{lC) is the standard mechanism used to communi¬ 
cate locally with hosts. 
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NAME 

test - conditioB commaod 

SYNOPSIS 

test «cpr 

DESCRIPTION 

teat evaluates the expression expr, and if its vsdue is true then returns zero exit status; otherwise, 
a non zero exit status is returned, teat returns a non zero exit if there are no arguments. 

The following primitives are used to construct expr. 

—T Ole true if the Ole exists and is readable. 

-w Ole true if the flie exists and u writable. 

-f Ole true if the Ole exists and is not a directory. 

-d Ole true if the Ole exists exists and is a directory. 

-t flIe true if the flIe exists and has a size greater than zero. 

-t [ Aides ] 

true if the open Ole whose file descriptor number is fiidea (1 by default) is associated 
with a terminal device. 

-B si true if the length of string al is zero. 

-n si true if the length of the string si is nonzero, 
si an s2 true if the strings at and aS are equal, 
si In s2 true if the strings al and aS are not equal, 
si true if al is not the null string, 

nl >«q n2 

true if the integers nl and nt are algebraically equal. Any of the comparisons -ne, 
-ge, -It, or -In may be used in place of -eq. 

These primaries may be combined with the following operators: 

1 unary negation operator 

-• binary and operator 

-o binary er operator 

( expr ) 

parentheses for grouping. 

-n has higher precedence than -o. Notice that all the operators and flags are separate arguments 
to teat. Notice also that parentheses are meaningful to the Shell and must be escaped. 


SEE ALSO 

sb(l), find(l) 
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NAME 

time - time a command 

SYNOPSIS 

time (command ] 

DESCRIPTION 

There are two distinct versions of time: it is buUt in to the C-shell, and is an executable program 
available in fbinltime when using the Bourne shell. In both cases, times are displayed on the 
diagnostic output stream. 

In the case of the C-shell, a time command with no command argument simply displays a sum¬ 
mary of time used by this shell and its children. When arguments are given the specified simple 
command is timed and the C-shell displays a time summary as described below under the time 
variable. If necessary, an extra shell is created to print the time statistic when the command 
completes. 

The default resource-usage summary is a line of the form: 

tiuu.tiu ew.es ee:ee pp% zxz-^ dddV m+ oooio mmmpf+ wurw 
where uuu.u is the user time (U), ees.e is the system time (S), ee:ee is the elapsed time (E), pp is 
the percentage of CPU time versus elapsed time (P), zxz is the average shared memory in Kilo¬ 
bytes (X), ddd is the average unshared data space in Kilobytes (D), Hi and ooo are the number of 
block input and output operations respectively (I and O), mmm is the number of page faults (M), 
and ww is the number of swaps (W). 

The time variable controk the display that the C-shell prints when it times a command. The 
time variable can be supplied with one or two values. The first value is a number — n for 
instance. The C-shell displays a resource-usage summary for any command running for more 
than n CPU seconds. The second value is optional and is a character string which determines 
which resources the user wishes displayed. The character string can be any string of text with 
embedded control key-letters in it. A control key-letter is a percent sign {%) followed by a single 
upper-case letter. To print a percent sign, use two percent signs in a row. Unrecognized key- 
letters are simply printed. The control key-letters are: 

D Average amount of unshared data space used in Kilobytes. 

E Elapsed (wallclock) time for the command. 

F Page faults. 

I Number of block input operations. 

K Average amount of unshared stack space used in Kilobytes. 

M Maximum real memory used during execution of the process. 

O Number of block output operations. 

P Total CPU time — U (user) plus S (system) — as a percentage of E (elapsed) 
time, 

S Number of seconds of CPU time consumed by the kernel on behalf of the user’s 
process. 

U Number of seconds of CPU time devoted to the user’s process. 

W Number of swaps. 

X Average amount of shared memory used in Kilobytes. 

The time command in */hin/time* times the given command, which must be specified, that is, 
command is not optional as it is in the C-shell’s timing facility. When the command is complete, 
time displays the elapsed time during the command, the time spent in the i^stem, and the time 
spent in execution of the command. Times are reported in seconds. 

EXAMPLES 

The two examples here show the difierences between the csh version of lime and the version in 
fbinjtime. The example assumes that csh is the shell in use. 
angei% time we /usr/man/manl/csh.l 
1876 11223 65895 /usr/man/manl/csh.l 
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2.7u 0.9$ 0:03 91% 3+ 6k 19+ 2io lpf+ Ow 
uigel% /bln/tlm* we /utr/maii/iiianl/e«h.l 
1876 11223 65895 /usr/man/manl/csh.l 
4.3 real 2.7 user 1.0 sys 
angel% 

BUGS 

Elapsed time is accurate to the second, while the CPU times are measured to the 50th second. 
Thus the sum of the CPU times can be up to a second larger than the elapsed time. 
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NAME 

tip, cu - connect to a remote system 
SYNOPSIS 

tip I -V 1 ( speed 1 system-name 
tip j -V J ( speed j phone-number 

cu phone-number [ -t ] ( -• epeed ] [ -a acu ) ( -I line If-#) 

DESCRIPTION 

Tip and cu establish a full-duplex connection to another machine, ^ving the appearance of being 
logged in directly on the remote computer. It goes without saying that you must have a account 
on the machine (or equivalent) to which you wish to connect. The preferred interface is tip. The 
cu interface is included for those people attached to the 'call UNIX’ command of version 7. This 
manual page describes only tip. 

When tip starts up it reads commands from the file Mprc in your home directory. If you use the 
-V option on the tip command line, tip displays these commands as it executes them. See the dis¬ 
cussion on variablee later on. 

Typed characters are normally transmitted directly to the remote machine (which does the echo¬ 
ing as well). A tilde (**"’*) appearing as the first character of a line is an escape signal; the follow¬ 
ing are recognized: 

Drop the connection and exit (you may still be logged in on the remote machine). 

"e [name] Change directory to name (no argument implies change to your home directory). 

*! Escape to a shell (exiting the shell will return you to tip). 

*> Copy file from local to remote. 

*'< Copy file from remote to local. 

"p from I to I 

Send a file to a remote UNIX host. When you use the put command, the remote 
UNIX system runs the command string 
cat > to 

while tip sends it the from file. If the to file isn’t specified, the from file name is used. 
This command is actually a UNIX specific version of the command. 

‘’t from ( I 

Take a file from a remote UNIX host. As in the put command the to file defaults to 
the from file name if it isn’t specified. The remote host executes the command string 
cat > from; echo 
to send the file to tip. 

**1 Pipe the output from a remote command to a local UNIX process. The command 

string sent to the local UNIX system is processed by the shell. 

"C Connect a program to the remote machine. The command string sent to the program 

is processed by the shell. The program inherits file descriptors 0 as remote line input, 
1 as remote line output, and 2 as tty standard error. 

# # Send a BREAK to the remote system. For systems which don’t support the neces¬ 

sary ioctl call the break is simulated by a sequence of line speed changes and DEL 
characters. 

"'a Set a variable (see the discussion below). 

“*2 Stop tip (only available when run under the C-Shell), 

Get a summary of the tilde escapes 
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Copying files requires some cooperation on the part of the remote host. When a ~> or ~< escape 
is used to send a file, tip prompts for a file name (to be transmitted or received) and a command 
to be sent to the remote system, in case the file is being transferred from the remote qrstem. The 
default end of transmission string for transferring a file from the local system to the remote is 
specified in the remote(5) file, but may be changed by the set command. While tip is transferring 
a file the number of lines transferred will be continuously displayed on the screen. A file transfer 
may be aborted with an interrupt. An example of the dialogue used to transfer files is given 
below (input typed by the user is shown in bold face). 

arpa% tip monet 
[connected] 

...(assume we are talking to another UNIX eystem),.. 

ucbmonet login: aam 

Password: 

monet% eat > foo.e 
~> Filename: foo.e 

32 lines transferred in 1 minute 3 seconds 
monet% 

monet% ~< Filename: reply.e 

List command for remote host: cat reply^ 

65 lines transferred in 2 minutes 
monet% 

...{or, equivalently)... 

monet% ~p foo.e 

...{actually eehoee aa ~fputj foo.e)... 

32 lines transferred in 1 minute 3 seconds 
monet% 

monet% ~t reply .e 

...{actually eehoee as ~[takej reply.e)... 

65 lines transferred in 2 minutes 
monet% 

...{to print a file locally)... 

monet% 'iLocal command: pr -h foo.e j Ipr 

List command for remote hoet: eat foo.e 

monet% "‘D 

[EOT] 

...{back on the local system)... 

The remote{5) file contains the definitions for remote systems known by tip; refer to the remote 
manual page for a full description. Each system has a default baud rate with which to establish a 
connection. If this value is not suitable, the baud rate to be used may be specified on the com* 
roand line, for example: 
tip -800 mdn 

When tip establishes a connection it sends out a connection message to the remote system. The 
default value for this string may be found in the remote file. 

At any time that tip prompts for an argument (for example, during setup of a file transfer) the 
line typed may be edited with the standard erase and kill characters. A null line in response to a 
prompt, or an interrupt, will abort the dialogue and return you to the remote machine. 

When tip attempts to connect to a remote system, it opens the associated device with an 
exclusive-open ioctl{2) call. Thus only one user at a time may access a device. This is to prevent 
multiple processes from sampling the terminal line. In addition, tip honors the locking protocol 
used by uucp{lC). 
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AUTO-CALL UNITS 

Tip may be used to dial up remote systems using a number of auto-call unit’s (ACU’s). When the 
remote system description contains the “du” attribute, tip will use the call-unit (“cu”), ACU type 
('*at”), and phone numbers (’’pn”) supplied. Normally tip will print out verbose messages as it 
dials. See remo/e(5) for details of the remote host specification. 

Depending on the type of auto-dialer being used to establish a connection the remote host may 
have garbage characters sent to it upon connection. The user should never assume that the first 
characters typed to the foreign host are the first ones presented to it. The recommended practice 
is to immediately type a '’kill” character upon establishing a connection (most UNIX systems sup¬ 
port ”Q” as the initial kill character). 

Tip currently supports the Ventel MD-212+ autodialer modem. 

REMOTE HOST DESCRIPTIONS 

Descriptions of remote hosts are normally located in the system-wide file fetcf remote. However, 
a user may maintain personal description files (and phone numbers) by defining and exporting the 
shell variable REMOTE. The remote file must be readable by tip, but a secondary file describing 
phone numbers may be maintained readable only by the user. This secondary phone number file 
defaults to letcfphoneo, unless the shell variable PHONES is defined and exported. As described 
in remote{S), the phones file is read when the host description’s phone number(s) capability is an 
”Q”. The phone number file contains lines of the form: 

system-name phone-number 

Each phone number found for a system is tried until either a connection is established, or an end 
of file is reached. Phone numbers are constructed from ‘'0123456789-=t*”, where the and 
are used to indicate a second dial tone should be waited for (ACU dependent). 

VARIABLES 

Tip maintains a set of variables which are used in normal operation. Some of these variables are 
read-only to normal users (root is allowed to change anything of interest). Variables may be 
displayed and set through the "s” escape. The ^ntax for variables is patterned after i;{(l) and 
mat7(l). Supplying "all” as an argument to the set command displays all variables readable by 
the user. Alternatively, the user may request display of a particular variable by attaching a ”?” 
to the end. For example "escape?” displays the current escape character. 

Variables are numeric, string, character, or boolean values. Boolean variables are set merely by 
specifying their name. They may be reset by prepending a "!” to the name. Other variable types 
are set by appending an and the value. The entire assignment must not have any blanks in 
it. A single set command may be used to interrogate as well as set a number of variables. Vari¬ 
ables may be initialized at run time by placing set commands (without the ""s” prefix in a file 
Mpre in one’s home directory). The -v option causes tip to display the sets as they are made. 

Finally, the variable names must either be completely specified or an abbreviation may be given. 
The following list details those variables known to tip, their abbreviations (surrounded by brack¬ 
ets), and their default values. Those variables initialized from the remote file are marked with a 
A mode is given for each variable; capitalization indicates the read or write capability is 


given only to the super-user. 


Variable 

Type Mode Default 

Description 

bejautify 

bool 

rw 

true 

discard unprintables when scripting 

ba]udrate 

num 

rW 

* 

connection baud rate 

dialjtimeout 

num 

rW 

60 

timeout (seconds) when establishing connection 

eofrjead 

str 

rw 


char’s signifying EOT from the remote host 

eofwjrite 

str 

rw 


string sent for EOT 
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eol] 

esjcape 

exjceptions 

fo]rce 

frlamesize 

hojst 

lock] 

log) 

phones] 

pr]oinpt 

ra]ue 

r]aue|c]har 

rec]ord 

remote] 

sc]ript 

tab]expaod 

verb]ose 

SHELL] 

HOME] 


str 

rw 

♦ 

end of line indicators 

char 

rw 


command prefix character 

str 

rw 

“\t\n\f\b” 

<^pl 

char’s not discarded due to beautification 

char 

rw 

force character 

num 

rw 

* 

size of buffering between writes on reception 

str 

r 

♦ 

name of host connected to 

str 

RW 

/tmp/aculock 

lock file for ACU togging 

str 

RW 

/usr/adm/aculog 

ACU log file 

str 

r 

/etc/phones 

‘\n’ 

file for hidden phone numbers 

char 

rW 

end of line indicator set by host 

bool 

rw 

false 

upper case mapping switch 

char 

rw 

“A’ 

interactive toggle for raise 

str 

rw 

*'tip.record” 

name of script output file 

str 

r 

/etc/remote 

system description file 

bool 

rw 

false 

session scripting switch 

bool 

rw 

false 

expand tabs during file transfers 

bool 

rw 

true 

make noise during file transfers 

str 

rw 

“/bin/sh” 

name of shell for escape 

str 

rw 


home directory for ~c escape 


ENVIRONMENT VARIABLES 

The following variables are read from the environment: 

REMOTE The location of the remote file. 

PHONES The location of the file containing private phone numbers. 
HOST A default host to connect to. 

HOME One’s log-in directory (for chdirs). 

SHELL The shell to fork on a "*'1” escape. 

FILES 

"/.tiprc initialization file. 

/usr/spool/uucp/LCK..* lock file to avoid conflicts with uuep 

DIAGNOSTICS 

Diagnostics are, hopefully, self explanatory. 

SEE ALSO 

reroote(5), phone8(5) 
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NAME 

touch - update date last modified of a file 
SYNOPSIS 

touch (-e I [ -f ] file ... 

DESCRIPTION 

Touch attempts to set the modified date of each fite. If the file exists, this is done by reading a 
character from the file and writing it back. 

Touch is valuable when used in conjunction with make(t), where, for instance, you might want to 
force a complete rebuild of a program composed of many pieces. In such a case, you might type, 
for example: 

% touch *.c 
% mako 

and the make would then see that all the .c files were more up to date than all the corresponding 
.o files, and would start the build from scratch. 

OPTIONS 

-c Do not attempt to create a file if it does not exist. 

-f Attempt to force the touch in spite of read and write permissions on a fite. 

SEE ALSO 

utimes(2) 
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NAME 

tr - translate characters 
SYNOPSIS 

tr ( -cds ] [ stringl ( 8tring2 ] ] 

DESCRIPTION 

Tr copies the standard input to the standard output with substitution or deletion of selected char* 
acters. The arguments ttringl and ttringS are considered sets of characters. Input characters 
found in etringl are ma^iped into the corresponding characters of string2. When strings is short it 
is padded to the length of etringl by duplicating its last character. 

In either string the notation a-b means a range of characters from a to ( in increasing ASCII 
order. The character '\’ followed by 1, 2 or 3 octal digits stands for the character whose ASCII 
code is given by those digits. A ‘\’ followed by any other character stands for that character. 

OPTIONS 

Any combination of the options -eds may be used: 

-{| Complement the set of characters in string! with respect to the universe of characters 
whose ASCn codes are 01 through 0377 octal; 

-d Delete all input characters in stringl; 

Squeese all strings of repeated output characters that are in strings to single characters. 

EXAMPLE 

The following example creates a list of all the words in ‘filel’ one per line in ‘file2’, where a word 
is taken to be a maximal string of alphabetics. The second string is quoted to protect ‘\’ from 
the Shell. 012 is the ASCII code for newline. 

tr-csA-Za-z \012'<filel >file2 

SEE ALSO 

ed(l), ascii(7), expand(l) 

BUGS 

Won’t handle ASCII NUL in stringl or stringS; always deletes NUL from input. 
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NAME 

troff - typeset or format documents 
SYNOPSIS 

troff { --opagelist ) | -nN\ [ -sTV] ( -m name ) ( -raN) I -I ] | -q) I -t J [ -f) ( -w ) ( -b | 

(—all I I fil® 1 • • • 

DESCRIPTION 

Troif formats text in the named files. The output is by default destined for printing on a Graphic 
Systems C/A/T phototypesetter, but suitable postprocessing software can convert the C/A/T 
output to a form which can be directed to other high-resolution devices. See also the nro^l) 
manual page, which describes a formatter which formats text for typewriter-like devices. The 
capabilities of both troff s^nd nroff are described in Formatting Documents with Nr off and Troff. 

If no file argument is present, the standard input is read. An argument consisting of a single 
minus (-) is taken to be a file name corresponding to the standard input. 

OPTIONS 

Options may appear in any order so long as they appear before the files. 

^olist Print only pages whose page numbers appear in the comma-separated list of numbers and 
ranges. A range iV-Af means pages N through Af; an initial -N means from the beginning 
to page N; and a final N- means from Nto the end. 

-nJV Number first generated page N. 


-mname 

Prepend the macro file /u9r/lib/tinae/tmac«name to the input files. 

-raAT Set register a (one-character) to N. 

-i Read standard input after the input files are exhausted. 

-q Invoke the simultaneous input-output mode of the rd request. 

-t Direct output to the standard output instead of the phototypesetter. In general, you will 
have to use this option if you don’t have a typesetter attached to the system. 

-a Send a printable ASCII approximation of the results to the standard output. 

Some options of troff only apply if you have a C/A/T typesetter attached to your system. These 
options are here for historical reasons: 


-*iV Stop every N pages. Troff stops the phototypesetter every AT pages, produces a trailer to 
allow changing cassettes, and resumes when the typesetter’s start button is pressed. 

-f Refrain from feeding out paper and stopping phototypesetter at the end of the run. 

-w Wait until phototypesetter is available, if currently busy. 

-b Report whether the phototypesetter is busy or available. No text processing is done. 

-pN Print all characters in point size N while retaining all prescribed spacings and motions, 

to reduce phototypesetter elasped time. 

If the file fusrladmftracct is writable, keeps phototypesetter accounting records there. The 
integrity of that file may be secured by making troff a ’set user-id’ program. 


FILES 


/tmp/ta* 

/usr/lib/tmac/tmac.* 

/usr/lib/term/* 

/usr/lib/font/^ 

/dev/cat 
/usr/adm/tracct 


temporary file 
standard macro files 
terminal driving tables for nroff 
font width tables for troff 
phototypesetter 

accounting statistics for /dev/cat 
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SEE ALSO 

Formatting Documento with Nroff and Troff in 
Editing and Text Proeetoing on the Sun Worketation 
Broff(l), eqn(l), tbl(l), m8(7), mc(7), man(7), «ol(l) 
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NAME 

true, false - provide truth values 

SYNOPSIS 

true 

fake 

DESCRIPTION 

True and /ake are usually used in a Bourne shell script. They test for the appropriate status 
"true” or ’’false” before running (or failing to run) a list of commands. 

EXAMPLE 

while true 
do 

command list 
done 

SEE ALSO 

csh(l), sh(l), false(l) 

DIAGNOSTICS 

True has exit status zero. 
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NAME 

tset - eatablish terminal characteristics for the environment 
SYNOPSIS 

taet [ -ee ] ( -ke ] ( - ] [ -n ) I ] I *'Q ] ( -m (ident)(test baudrate]:type ] • •• (type ] 
reset... 

DESCRIPTION 

Tfet sets up your terminal when you first log in to a UNIX system. It does terminal dependent 
processing such as setting erase and kill characters, setting or resetting delays, sending any 
sequences needed to properly initialized the terminal, and the like. Ttet first determines the tj/pe 
of terminal involved, and then does necessary initializations and mode settings. The (ype of ter¬ 
minal attached to each UNIX port is specified in tht fete/ttytype database. Type names for termi¬ 
nals may be found in the termeap{b) database. If a port is not wired permanently to a specific 
terminal (not hardwired) it is given an appropriate generic identifier such as dialup. 

When no arguments are specified, teet simply reads the terminal type out of the TERM environ¬ 
ment variable and re-initializes the terminal. The rest of this manual entry deals with mode and 
environment initialization — typically done once at login — and options used at initialization 
time to determine the terminal type and set up terminal modes. 

When used in a startup script (.profile for «h(l) users or .login for csh(l) users) it is desirable to 
five information about the type of termini you will usual^ use on ports which are not 
hardwired. These ports are identified in fete/ttytype as dialup or plugboard or arpanet, etc. To 
specify what termmal type you usually use on these ports, the -m (map) option fiag is followed 
by the appropriate port type identifier, an optional baud rate specification, and the terminal type, 
(The effect is to "map” from some conditions to a terminal type, that u, to tell toet "If I’m on 
this kind of port, guess that I'm on that kind of terminal”.) If more than one moping is specified, 
the first applicable mapping prevails. A missing port type identifier matches all identifiers. Any 
of the alternate generic names given in terminfo may be used for the identifier. 

A baudrate is specified as with sf(]/(l), and is compared with tbe speed of the diagnostic output 
(which should be the control terminal). The baud rate test may be any combination of: >, O, 
<, and I; O means "at” and I inverts the sense of the test. To avoid problems with metacharac¬ 
ters, it is best to place the entire argument to -m within (apostrophe) characters; users of 
esh(l) must also put a “\” before any "I” used here. 

Thus, the command ' 

tset-m 'dialup>300;adm3a'-m dialup:dw2-m VIugboard:?adm3a'’ 

sets the termind type to admSa if the port in use is a dialup at a speed greater than 300 baud; to 
a dwt if the port is (otherwise) a dialup (that is, at 300 baud or less). If the type finally deter¬ 
mined by tset begins with a question mark, the user is asked if s/he really wants that type. A 
null response means to use that type; otherwue, another type can be entered which will be used 
instead. Thus, in the above case, the user is queried on a plugboard port as to whether s/he is 
actually using an admSa. 

If no mapping applies and a final type option, not preceded by a -m, is given on the command 
line then that type is used; otherwise the identifier found in the fete/ttytype database b used as 
the terminal type. Thb should always be tbe case tor hardwired ports. 

It b usually desirable to return the terminal type, as finally determined by tset, and information 
about the terminal’s capabilities to a shell’s environment. Thb can be done using the - option; 
using the Bourne shell, «h(l): 

export TERM; .TERM=*tset - options...' 
or using tbe C shell, e«A(l): 

setenv TERM ‘tset - options...' 


Sun Release 1.1 


Last change: Id March 1984 


323 





TSET(l) 


USER COMMANDS 


TSET(l) 


With ceh it is convenient to make an alias in your .cshrc: 

alias tset 'setenv TERM 'tset - \!*'' 

Either of these aliases allow the command 
tset 2621 

to be invoked at any time from your login csh. ”Note to Bourne Shell userst* It is not possi* 
ble to get this aliasing effect with a shell script, because shell scripts cannot set the environment 
of their parent. If a process could set its parent’s environment, none of this nonsense would be 
necessary in the first place. 

Once the terminal type is known, tset engages in terminal driver mode setting. This normally 
involves sending an initialization sequence to the terminal, setting the single character erase (and 
optionally the line-kill (full line erase)) characters, and setting special character delays. Tab and 
newline expansion are turned off during transmission of the terminal initialization sequence. 

On terminals that can backspace but not overstrike (such as a CRT), and when the erase character 
is the default erase character ('#’ on standard systems), the erase character is changed to BACK¬ 
SPACE (Control-H). 

If tset is invoked as reset, it will set cooked and echo modes, turn off ebreak and raw modes, 
turn on newline translation, and restore special characters to a sensible state before any terminal 
dependent processing is done. Any special character that is found to be null or "-1” is reset to 
its default value. 

This is most useful after a program dies leaving a terminal in a funny state. You may have to 
type “<LF>re8et<LF>” to get it to work since <CR> may not work in this state. Often none of 
this will echo. 

EXAMPLES 

These examples all assume the Bourne shell and use the - option. If you use eeh, use one of the 
variations described above. Note that a typical use of teet in a .profile or .login will also use the 
-e and -k options, and often the -n or -Q options as well. These options have not been 
included here to keep the examples small. (NOTEt some of the examples given here appear to 
take up more than one line, for text processing reasons. When you type in real teet commands, 
you must enter them entirely on one line.) 

At the moment, you are on a 2621. This is suitable for typing by hand but not for a .profile, 
unless you are alwaye on a 2621. 

export TERM; TERM=*tset - 2621' 

You have an hl9 at home which you dial up on, but your office terminal is hardwired and known 
in /etc/ttytype. 

export TERM; TERM=3'tset —m dialup;hl9' 

You have a switch which connects everything to everything, making it nearly impossible to key 
on what port you are coming in on. You use a vtlOO in your office at 9600 baud, and dial up to 
switch ports at 1200 baud from home on a 2621. Sometimes you use someone else’s terminal at 
work, so you want it to ask you to make sure what terminal type you have at high speeds, but at 
1200 baud you are always on a 2621. Note the placement of the question mark, and the quotes to 
protect the greater than and question mark from interpretation by the shell. 

export TERM; TERM=»'tset - -m ’switch>1200:?vtl00’ -m ’8witch<a=1200:2621’ 

All of the above entries will fall back on the terminaklype specified in fetefttytype if none of the 
conditions hold. The following entry is appropriate if you always dial up, dways at the 
baud rate, on many different kinds of terminals. Your most common terminal is an admSa. It 
always asks you what kind of terminal you are on, defaulting to admSa. 

export TERM; TERM='t8et - ?adm3a' 
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If the file /ete/Uytype is not properly installed and you want to key entirely on the baud rate, the 
followinf can be used: 

export TERK^ TERMa»*tset — m ’>1200:vtl00’ 2621' 

Here is a fancy example to illustrate the power of teet and to hopelessly confuse anyone who has 
made it this far. You dial up at 1200 baud or less on a conceptlOO, sometimes over switch ports 
and sometimes over regular dialups. You use various terminals at speeds higher than 1200 over 
switch ports, most often the terminal in your office, which is a vtlOO. However, sometimes you 
log in from the university you used to go to, over the ARPANET; in this case you are on an 
ALTO emulating a dm2600. You also often log in on various hardwired ports, such as the con¬ 
sole, all of which are properly entered in letefttytype. You want your erase character set to con¬ 
trol H, your kill character set to control U, and don't want tact to print the "Erase set to Back¬ 
space, Kill set to Control U" message. 

export TERM; TERM««*tset -e -k*U -Q - -m 'switch<“1200:conceptl00' -m 
'switch:?vtl00' -m dialup:eoneeptl00 -m arpanet:dm2600* 

OPTIONS 

-ee set the erase character to be the named character e on all terminab, the default being the 
backspace character on the terminal, usually 'H. The character e can either be typed 
directly, or entered using the hat notation used here. 

-Ice is similar to -e but for the line kill character rather than the erase character; e defaults 
to *U (for purely historical reasons). The kiU characters is left alone if -k is not 
specified. The hat notation can also be used for thb option. 

- The name of the terminal finally decided upon is output on the standard output. Thb is 
intended to be captured by the shell and placed in the TERM environment variable. 

-B On systems with the Berkeley ffiSD tty driver, specifies that the new tty driver modes 
should be initialized for this terminal. For a CRT, the CRTERASE and CRTKILL modes 
are set only if the baud rate b 1200 or greater. 

-I suppresses transmitting terminal-initialization strings. 

-Q suppresses printing the "Erase set to'' and "Kill set to'' messages. 

FILES 

/etc/ttytype port name to terminal type mapping database 

/etc/termcap terminal capability database 

/usr/Iib/tabset/* tab setting sequences for various terminals. Pointed to by termcap 
entries. 

SEE ALSO 

esh(l), sb(l), stty(l), ttytype(5), termcap(5), environ(5) 

BUGS 

The tact command b one of the first commands a user must master when getting started on a 
UNIX system. Unfortunately, it is one of the most complex, largely because of the extra effort 
the user must go through to get the environment of the login shell set. Something needs to be 
done to make all thb simpler, either the /oytn(l) program should do thb stuff, or a default shell 
alias should be made, or a way to set the envbonment of the parent should exist. 


Sun Release 1.1 


Last change; 19 March 1984 


325 





TSORT(l) 


USER COMMANDS 


TSORT(l) 


NAME 

tsort - topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list of items consistent with a partial 
ordering of items mentioned in the input file. If no file is specified, the standard input is under^ 
stood. 

The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different 
items indicate ordering. Pairs of identical items indicate presence, but not ordering. 

SEE ALSO 

lorder(l) 

BUGS 

Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive file. 



c 


326 


Last change: 8 August 1683 


Sun Release 1.1 








TTY(l) 


USER COMMANDS 


TTY(l) 


NAME 

tty - get terminal name 
SYNOPSIS 

tty 1 -a 1 

DESCRIPTION 

Tty prints the pathname of the user’s terminal unless the -a (silent) option is given. In either 
ease, the exit value is zero if the standard input is a terminal, and one if it is not. 
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NAME 

ul - do underlining 
SYNOPSIS 

ul I —i ] I —t terminal ] | file ... ] 

DESCRIPTION 

Ul reads the named JUea (or standard input if none are given) and translates occurrences of under* 
scores to the sequence which indicates underlining for the terminal in use, as specified by the 
environment variable TERM, ul uses the jeteftermeap file to determine the appropriate 
sequences for underlining. If the terminal is incapable of underlining, but is capable of a standout 
mode then that is used instead. If the terminal can overstrike, or handles underlining automati¬ 
cally, ul degenerates to cal(l). If the terminal cannot underline, underlining is ignored. 

OPTIONS 
-t 

-1 


SEE ALSO 

man(l), nroff(l), colcrt(l) 

BUGS 

Nro^usually generates a series of backspaces and underlines intermixed with the text to indicate 
underlining. Ul makes attempt to optimize the backward motion. 


Override the terminal kind specified in the environment. If the terminal cannot under¬ 
line, underlining is ignored. 

Indicate underlining onto by a separate line containing appropriate dashes this is use¬ 
ful when you want to look at the underlining which is present in an nroff output stream 
on a crt-terminal. 
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NAME 

unget - undo a previous get of an SCCS file 
SYNOPSIS 

/usr/seca/unget {-r SID ](-■)[ -n | file ... 

DESCRIPTION 

Unget undoes the effect of a get -e done prior to creating the intended new delta. If a directory 
is named, unget behaves as though each file in the directory were specified as a named file, except 
that noo'SCCS files and unreadable files are silently ignored. If a name of — is given, the standard 
input is read with each line being taken as the name of an SCCS file to be processed. 

OPTIONS 

Options apply independently to each named file. 

-r SID Uniquely identifies which delta is no longer intended. (This would have been specified by 
get as the “new delta”). The -r option is necessary only if two or more outstanding gets 
for editing on the same SCCS file were done by the same person (login name). A diagnos¬ 
tic results if the specified SID is ambiguous, or if it is necessary but omitted from the 
command line. 

-a Suppress displaying the intended delta’s SID. 

-n Retain the gotten file — it is normally removed from the current directory. 

SEE ALSO 

sccs(l), delta(l), get(l), sact(l). 

Source Code Control Syetem in Programming Toole for the Sun Workstation. 

DIAGNOSTICS 

Use help{l) tot explanations. 
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NAME 

uniq - report repeated lines in a file 
SYNOPSIS 

unlq I -ude I +n ] ( -n ] ] (input ( output) ] 

DESCRIPTION 

Uniq reads the input file comparing adjacent lines. In the normal case, the second and succeeding 
copies of repeated lines are removed; the remainder is written on the output file. Note that 
repeated lines must be adjacent in order to be found; see «orf(l). 

OPTIONS 

-u Copy only those lines which are not repeated in the original file. 

-d Write one copy of just the repeated lines. 

The normal output of uniq is the union of the -u and -hI options 

-e supersedes -u and -d and generates an output report in default style but with each line 
preceded by a count of the number of times it occurred. 

The n arguments specify skipping an initial portion of each line in the comparison: 

-n The first n fields together with any blanks before each are ignored. A field is defined as 
a string of non-space, non-tab characters separated by tabs and spaces from its neigh¬ 
bors. 

•fn The first n characters are ignored. Fields are skipped before characters. 

SEE ALSO 

sort(l), comm(l) 
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NAME 

units - conversion program 

SYNOPSIS 

units 

DESCRIPTION 

Unit$ converts quantities expressed in various standard scales to their equivalents in other scales. 
It works interactively in this fashion: 

You have: inch 
You want: cm 

*S.S4000e+00 
I S.9S701e-01 

A quantity is specified as a multiplicative combination of units optionally preceded by a numeric 
multiplier. Powers are indicated by suflSxed positive integers, division by the usual sign; 

You have: 15 pounds force/in2 
You want: atm 

• 1.02089e+ 00 
/ 9.797S0e-01 

Unite only does multiplicative scale changes. Thus it can convert Kelvin to Rankine, but not 
Centigrade to Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, 
together with a generous leavening of exotica and a few constants of nature including: 


pi 

ratio of circumference to diameter 

c 

speed of light 

e 

charge on an electron 

S 

acceleration of gravity 

force 

same as g 

mole 

Avogadro’s number 

water 

pressure head per unit height of water 

au 

astronomical unit 


‘Pound’ is a unit of mass. Compound names are run together, e.g. ‘lightyear’. British units that 
differ from their US counterparts are prefixed thus: ‘brgallon’. Currency is denoted ‘belgium* 
franc’, ‘britainpound’, ... 

For a complete list of units, ‘cat /usr/lib/units'. 

FILES 

/usr/lib/units 

BUGS 

Don’t base your financial plans on the currency conversions. 
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NAME 

uptime - show how long system has been up 

SYNOPSIS 

uptime 

DESCRIPTION 

Uptime prints the current time, the length of time the system has been up, and the average 
number of jobs in the run queue over the last 1, 5 and IS minutes. It is, essentially, the first line 
of a u;(l) command. 

EXAMPLE 

angel% uptime 

6:47am up 6 days, 16:38, 1 users, load average: 0.69, 0.28, 0.17 
angel% 

FILES 

/vmunix system name list 

SEE ALSO 
w(l) 
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NAME 

uaen - compact list of users who are on the system 

SYNOPSIS 

UBurs 

DESCRIPTION 

Vttrt luts the login names of the users currently on the qrstem in a compact, one>Iine format: 

% users 
John paul george 

% 

FILES 

/etc/utmp 

SEE ALSO 

wbo(l) 
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NAME 

UUCP, uulog - Unix to unix copy 
SYNOPSIS 

UUCP [ option ] ... source-file ... destination-file 
uulog [ option ] ... 

DESCRIPTION 

Uucp copies files named by the source-file arguments to the destination-file argument. A file name 
may be a path name on your machine, or may have the form. 

sy stem-n ame! pathname 

where ^system-name’ is taken from a list of system names which uucp knows about. Shell meta¬ 
characters ^ * [] appearing in the pathname part will be expanded on the appropriate ^stem. 

Pathnames may be one of 

(1) a full pathname; 

(2) a pathname preceded by "user; where user is a userid on the specified ^stem and is 
replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

If the result is an erroneous pathname for the remote system the copy will fail. If the 

destination-file is a directory, the last part of the source-file name is used. 

Uucp preserves execute permissions across the transmission and gives 0666 read and write permis¬ 
sions (see chmod(2)), 

UUCP OPTIONS 

The following options are interpreted by uucp, 

-d Make all necessary directories for the file copy. 

-e Use the source file when copying out rather than copying the file to the spool directory, 

-m Send mail to the requester when the copy is complete. 

UULOG OPTIONS 

Uulog maintains a summary log of uucp and uux(lC) transactions in the file 
lusrfspool/uucplLOGFILE by gathering information from partial log files named 
fusrfspoolf uucp/LOG.*, f. It removes the partial log files. 

The options cause uulog to print logging information: 

Print information about work involving system sys. 

^uueer Print information about work done for the specified user. 

FILES 

/usr/spool/uucp spool directory 

/usr/lib/uucp/* other data and program files 

SEE ALSO 

uux(lC), mail(i) 

Uucp Implementation Description in the Sun System Manager's Manual. 

WARNING 

The domain of remotely accessible files can (and for obvious security reasons, usually should) be 
severely restricted. You will very likely not be able to fetch files by pathname; ask a responsible 
person on the remote system to send them to you. For the same reasons you will probably not be 
able to send files to arbitrary pathnames. 
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BUGS 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. Receiving multiple files 
specified by special shell characters ? * [) will not activate the -m option. 
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NAME 

uuencode^uudecode - encode/decode a binary file for transmission via mail 
SYNOPSIS 

uuencode [ source-file ] destination-file | mail sysi!^s2!...!decode 
uudecode [ source-file j 

DESCRIPTION 

Uuencode and uudecode are used to send a binary file via uucp (or other) mail. This combination 
of commands can be used over indirect mail links even when utisend( 1C) is not available. 

Uuencode takes the named source file (default standard input) and produces an encoded version 
on the standard output. The encoding uses only printing ASCII characters, and includes the 
mode of the file and the remotedeei for recreation on the remote system. 

Uudecode reads an encoded file, strips off any leading and traUing lines added by mailers, and 
recreates the original file with the specified mode and name. 

The intent is that all mail to the user “decode” should be filtered through the uudecode program. 
This way the file is created automatically without human intervention. This is possible on the 
uucp network by either using eendmail or by making rmaU be a link to Mail instead of mail. In 
each case, an alias must be created in a master file to get the automatic invocation of uudecode. 

If these facilities are not available, the file can be sent to a user on the remote machine who can 
uudecode it manually. 

The encode file has an ordinary text form and can be edited by any text editor to change the 
mode or remote name. 

SEE ALSO 

uuencode(5), uusend(lC), uucp(lC), uux(lC), mail(l) 

BUGS 

The file is expanded by 35% (3 bytes become 4 plus control information) causing it to take longer 
to transmit. 

The user on the remote system who is invoking uudecode (often uucp) must have write permission 
on the specified file. 
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NAME 

uusend - send a file to a remote host 
SYNOPSIS 

uusend (-m mode ] sourcefile sysl!sy82!..!remotefile 
DESCRIPTION 

Uusend sends a file to a given location on a remote system. The system need not be directly con* 
nected to the local system, but a chain of ttucy(lC) links needs to connect the two systems. 

The sourcefile can be meaning to use the standard input. Both of these options are primarily 
intended for internal use of uusend. 

The remotefile can include the ‘userid syntax. 

OPTIONS 

-m mode 

Take the mode of the file on the remote end from the octal number specified as mode. 
The mode of the input file is used if the -m option is not specified. 

DIAGNOSTICS 

If anything goes wrong any further away than the first system down the line, you will never hear 
about it. 

SEE ALSO 

uux(lC), uucp(IC), uuencode(IC) 

BUGS 

This command shouldn’t exist, since uucp should handle it. 

All aystems along the line must have the uusend command available and allow remote execution 
of it. 

Some UUCP systems have a bug where binary files cannot be the input to a uux command. If this 
bug exists in any system along the line, the file will show up severely munged. 
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NAME 

uux - Unix to Unix command execution 
SYNOPSIS 

uux I - ] command-string 
DESCRIPTION 

Uux will gather 0 or more files from various systems, execute a command on a specified iqrstem 
and send standard output to a file on a specified system. 

The command-string is made up of one or more arguments that look like a shell command line, 
except that the command and file names may be prefixed by system-name!. A null ^stem-name 
is interpreted as the local system. 

FUe names may be one of 

(1) a full pathname; 

(2) a pathname preceded by ^xzx; where xxx is a userid on the specified system and is 
replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

The option will cause the standard input to the uux command to be the standard input to the 
command-string. 

For example, the command 

uux ’’Idiff U8g!/usr/dan/fl pwba!/a4/dan/fl > Ifi.diflT 

will get the fl files from the usg and pwba machines, execute a dt^command and put the results 
in fl.diff in the local directory. 

Any special shell characters such as <>;| should be quoted either by quoting the entire 
command-string, or quoting the special characters as individual arguments. 

FILES 

/usr/spool/uucpspool directory 
/usr/lib/uucp/* other data and programs 

SEE ALSO 

uucp(lC) 

D. A. Nowitz, Uucp Implementation Deecription 
WARNING 

An installation may, and for security reasons generally will, limit the list of commands executable 
on behalf of an incoming request from uux. Typically, a restricted site will permit little other 
than the receipt of mail via uux. 

BUGS 

Only the first command of a shell pipeline may have a system-name!. All other commands are 
executed on the system of the first command. 

The use of the shell metacharacter * will probably not do what you want it to do. 

The shell tokens << and >> are not implemented. 

There is no notification of denial of execution on the remote machine. 
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NAME 

val - validate SOOS file 

SYNOPSIS 

/uar/aees/val - 

/uar/iees/val ( -a | [ -r SID j [ -m name j [ -y typt J file ... 

DESCRIPTION 

Vtf/ determines if the specified file u «a SCCS file meeting the characteristics specified by the 
optional argument list. Arguments to val may appear in any order. 

Val has a special argument, which causes reading of the standard input until an end-of-file con¬ 
dition is detected. Each line read is independently processed as if it were a command line argu¬ 
ment list. 

Val generates diagnostic messages on the standard output for each command line and file pro¬ 
cessed and also returns a single 8-bit code upon exit as described below. 

OPTIONS 

Options apply independently to each named file on the command line. 

-a Silence diagnostic messages normally generated for errors detected while processing the 
specified files. 

-r5/D The argument value f/D (5CCS/Dentification String) is an SCCS delta number. A check 
is made to determine if the SID is ambiguous (for instance, rl is ambiguous because it 
physically does not exist but implies 1.1, 1.2, etc. which may exist) or invalid (for 
instance, rl.O or rl.1.0 are invalid because neither case can exist as a valid delta 
number). If the 5/D is valid and not ambiguous, a check is made to determine if it actu¬ 
ally exists. 

-m name 

name is compared with the SCCS %M% keyword in file. 

-y type type u compared with the SCCS %Y% keyword in file. 

The 8-bit code returned by val is a disjunction of the possible errors, that is, can be interpreted as 
a bit string where (moving from left to right) set bits are interpreted as follows: 

bit 0 s missing file argument; 

bit 1 V unknown or duplicate option; 

bit 2 w corrupted SCCS file; 

bit 3 « can’t open file or file not SCCS; 

bit 4 « SID u invalid or ambiguous; 

bit 5 ■■ SID does not exist; 

bit 6 V %Y%, -y mismatch; 

bit 7 « %M%, -m mismatch; 

Note that val can process two or more files on a given command line and in turn can process mul¬ 
tiple command lines (when reading the standard input). In these cases an aggregate code is 
returned — logical OR of the codes generated for each command line and file processed. 

SEEAL80 

sccs(l), admin(l), delts(l), get(l), prs(l). 

Sauree Code Control Syetem in Programming Toole for the Sun Worketation. 

DIAGNOSTICS 

Use ke/p(l) for explanations. 

BUGS 

Val can process up to 50 files on a single command line. Any number above 50 will produce a 
eore dump. 
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NAME 

vax - is current machine a vax 
SYNOPSIS 

If vax| then ...} fl (fh) 

If { vax } then (cah) 

eee 

endlf 

DESCRIPTION 

The vax command is, on VAX’en, the same as irue(l); on Sun Workstations and other machines it 
is the same as /a/se(l). 

SEE ALSO 

false(l), 8un(l), true(l) 
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NAME 

vgrind - grind nice listings of programs 
SYNOPSIS 

vgrind (-f 11 -1 I -t 1 ( -n I ( -X ) ( -W j (-sn ) (-h header) ( -d file | ( -Slanguage J file ... 
DESCRIPTION 

Vgrind formats the program sources which ate file arguments in a nice style using trofi{l). Com¬ 
ments are placed in italics, keywords in bold face, and the name of the current function is listed 
down the margin of each page as it is encountered. 

Vgrind runs in two basic modes, filter mode or regular mode. In filter mode vgrind acts as a filter 
in a manner similar to The standard input is passed directly to the standard output except 

tot lines bracketed by the (ro#-like macros: 

.vS • starts processing 

.vE - ends processing 

These lines are formatted as described above. The output from this filter can be passed to troff 
tor output. There need be no particular ordering with e 9 n(l) or 161(1). 

In regular mode vgrind accepts input files, processes them, and passes them to trofi[l) for output. 
In both modes vgrind passes any lines beginning with a decimal point without conversion. 
OPTIONS 

-f force filter mode. 

- take from standard input (default if -f is specified). 

-t similar to the same option in troff, that is, formatted text goes to the standard output. 

-n do not make keywords boldface. 

—X output the index file in a ‘pretty’ format. The index file itself is produced whenever 
vgrind is run with a file called index in the current directory. The index of function 
definitions can then be run off by giving vgrind the -x option and the file index as argu¬ 
ment. 

—W force output to the (wide) Versatec printer rather than the (narrow) Varian. 

-a specifies a point size to use on output (exactly the same as the argument of a troff .ps 

(point size) request. 

—h specifies a particular header to put on every output page (default is the file name). 

-d specifies an alternate language definitions file (default is luBrjtibfvgrindefe). 

-1 specifies the language to use. Currently known are PASCAL (-Ip), C (-le the default), 

CSH (-leah), SHELL (-lah), RATFOR (-Ir), and ICON (-U). 

FILES 

index file where source for index is created 

/usr/lib/tmac/tmac.vgrind macro package 

/usr/lib/vfontedpr preprocessor 

/usr/Ub/vgrindefs language descriptions 

BUGS 

Vfontedpr assumes tnat a certain programming style is followed: 

For C - function names can be preceded on a line only by spaces, tabs, or an asterisk. The 
parenthesized arguments must also be on the same line. 

For PASCAL ~ function names need to appear on the same line as the keywords function or pro¬ 
cedure. 
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If these conventions are not followed, the indexing and marginal function name comment mechan* 
isms will fail. 

More generally, arbitrary formatting styles for programs mostly look bad. The use of spaces to 
align source code fails miserably; if you plan to vgrind your program you should use tabs. This is 
somewhat inevitable since the font used by vgrind is variable width. 

The mechanism of ela^s(l) in recognizing functions should be used here. 
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NAME 

vi - screen oriented (visual) display editor based on ex 
SYNOPSIS 

vl ( -t tag I I -r ) I +commani 1 (-Ill I ••• 

DESCRIPTION 

Vi (visual) is a display oriented text editor based on ez(l). Ex and vi are in fact the same text 
editor; it is possible to get to the command mode of ex from within vi and vice-versa. 

FILES 

See ex(l). 

SEE ALSO 

ex (1), edit (1), “Vi Quick Reference” card, 

Using vi, the Visual Display Editor in 

Editing and Text Processing on the Sun Workstation, 

BUGS 

Software tabs using “T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals don’t make use of insert and delete character operar 
tions in the terminal. 

The wrapmargin option can be fooled since it looks at output columns when blanks are typed. If 
a long word passes through the margin and onto the next line without a break, then the line 
won’t be broken. 

Repeating a change which wraps over the margin when wrapmargin is in effect doesn’t generally 
work well: sometimes it just makes a mess of the change, and sometimes even leaves you in insert 
mode. A way to work around the problem is to replicate the changes using yank and put. 

Insert/delete within a line can be slow if tabs are present on intelligent terminals, since the termi¬ 
nals need help in doing this correctly. 

Saving text on deletes in the named buffers is somewhat inelBcient. 

The source command does not work when executed as »ouree; there is no way to use the 
tappeitd, mhange, and tlnaert commands, since it is not possible to give more than one line of 
input to a t escape. To use these on a tglobal you must Q to ez command mode, execute them, 
and then reenter the screen editor with vi or open. 
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NAME 

vi - view a file without changing it using the vi visual editor 
SYNOPSIS 

view (-t tag I ( -r ] { +command 11-1)1 -wn j name ... 

DESCRIPTION 

View uses the vi (visual) or display oriented text editor to browse through a file interactively 
without actually making any changes to the file. It is possible to get to the command mode of ex 
from within view and vice-versa, just as when using vi. 

FILES 

See ex{l). 

SEE ALSO 

ex (1), edit (1), “Vi Quick Reference” card, 

Using vi, the Visual Display Editor in 

Editing and Text Processing on the Sun Workstation. 
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NAME 

vplot - plot graphics OB the Venatec 
SYNOPSIS 

vplot ( -W JI-V ] [ ~b/pr*orif I file 
DESCRIPTION 

Vplot reads piot(5) format graphics input from the file specified by (standard input if nois 
specified) and produces a plot on the Varian or Versatec. 

OPTIONS 

-W force output to the (wide) Versatec printer rather than the standard Versatec printer. 

—V force output to the standard Versatec printer. 

-b IpT'org 

srg (the next argument on the command line) specifies extra arguments to fpr(l). 

SEEAESO 

plOt(lG), lpr(l), plot(S) Reads standard graphics input and produces a plot on the Varian or Ver* 
satec 
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NAME 

vswap - convert a foreign font file 

SYNOPSIS 

VBwap (-r J 

DESCRIPTION 

Without the -r option vswap translates its standard input (which must be a vfont file in the 
reversed byte order) into a locally correct vfont file on its standard output. With the ~r option 
vswap translates ite standard input (which must be a vfont file in the local byte order) into a 
byte-reversed vfont file on its standard output. 

The UNDC vfont representation for fonts is a binary file containing machine-dependent elements - 
short (16-bit) integers, in particular. There are (at least) two common ways of representing a 16- 
bit integer. A program compiled on a VAX will expect the VAX format, while the same program 
compiled on a Motorola 68000 will expect 68000 format. Vswap can be used to convert font files 
created on a VAX to the format required to use them on the Sun. It can also convert Sun-format 
font files to VAX format (with the -r option). Since the font files are in the byte order of the 
local machine, programs which access the font files don’t need to be concerned with byte¬ 
swapping issues. This could be considered a bug. 

SEE ALSO 

troff(l), vfont(5) 

BUGS 

A machine-independent font format should be defined. 
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NAME 

w - who is on and what they are doing 

SYNOPSIS 

w(-h)(-.l(u«erl 

DESCRIPTION 

H'’ displays a sununary of the current activity on the system, including what each user is doing. 
The heading line shows the current time of day, how long the system has been up, the number of 
users logged into the system, and the load averages. The load average numbers give the number 
of jobs in the run queue averaged over 1, 5 and 15 minutes. 

The fields displayed are: the users login name, the name of the tty the user is on, the time of day 
the user logged on, the number of minutes since the user last typed anything, the CPU time used 
by all processes and their children on that terminal, the CPU time used by the currently active 
processes, the name and arguments of the current process. 

If a user name is included, output is restricted to that user. 

OPTIONS 

-h Suppress the heading. 

-4 Produce a short form of output. In the short form, the tty is abbreviated, the login time 
and cpu times are left off, as are the arguments to commands. 

—1 Produce a long form of output, which is the default. 

EXAMPLE 

angel% w 

7:36am up 6 days, 16:45, 1 users, load average: 0.20, 0.23, 0.18 
User tty loginO idle JCPU PCPU what 

henry console 7:10am 1 10:05 4:31 w 

angel% 

FILES 

/etc/utmp 

/dev/kmem 

/dev/drum 

SEE ALSO 

who(l), ps(l), utmp(5) 

BUGS 

The notion of the "cunent process” is muddy. The current algorithm is "the highest numbered 
process on the terminal that is not ignoring interrupts, or, if there is none, the highest numbered 
process on the terminal”. This faffs, for example, in critical sections of programs like the shell 
and editor, or when faulty programs running in the background fork and fail to ignore interrupts. 
(In cases where no process can be found, w prints 

The CPU time is only an estimate, in particular, if someone leaves a background process running 
after logging out, the person currently on that terminal is “charged” with the time. 

Background processes are not shown, even tbough they account for much of the load on the sys¬ 
tem. 

Scmietimes processes, typically those in the background, are printed with null or garbaged argu¬ 
ments. In these cases, the name of the command is printed in parentheses. 

W does not know about the new conventions for detecting background jobs. It will sometimes 
find a background job instead of the right one. 
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NAME 

wait - await completion of process 

SYNOPSIS 

wait 

DESCRIPTION 

Wait until all processes started with & or bg have completed, and report on abnormal termina¬ 
tions. 

Because the wait{2) system call must be executed in the parent process, the Shell itself executes 
wait, without creating a new process. 

SEE ALSO 

8h(l), csh(l) 

BUGS 

Not all the processes of a 3> or more-stage pipeline are children of the Shell, and thus can’t be 
waited for. (This bug does not apply to csA(l).) 
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NAME 

wtdl - write to all users 

SYNOPSIS 

wall I file I 
DESCRIPTION 

Wall reads its standard input until an end*of-file. It then sends this message, preceded by 'Broad* 
cast Message to all logged in users. 

The sender should be super*user to override any protections the users may have invoked. 

FILES 

/dev/tiy? 

/etc/utmp 

SEE ALSO 

mesg(l), write(l) 
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NAME 

wc - word count 

SYNOPSIS 

we ( -Iwc ] [ file ... ] 

DESCRIPTION 

Wc counts lines, words, and characters in the named files, or in the standard input if no file 
names appear. A word is a string of characters delimited by spaces, tabs, or newlines. 

OPTIONS 

If an argument beginning with one of *Iwc’ is present, the specified counts are selected by the 
letters: 

1 Count lines, 

w Count words, 

e Count characters. 

The default is -Iwe (count lines, words, and characters). 

EXAMPLE 

angel% we/usr/man/manl/{esh.l,8h.l,teinet.l} 

1876 11223 65895 /usr/man/manl/csh.l 

674 3310 20338 /usr/man/manl/sh.l 

260 1110 6834 /usr/man/manl/telnet.l 

2810 15643 93067 total 

angel% 





c 
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NAME 

what - identify the version of files 

SYNOPSIS 

what files 

DESCRIPTION 

What searches the given filea for all occurrences of the pattern that substitutes for %Z% 

(this is 0 (#) at this printing) and prints out what follows until the first new-line, \, or null 
character. For exunple, if the C program in Ble program.e contains 

char ident(] ”Q(#)identification information”; 
and program,e w compiled to yield program.o md a.out, the command 


what feC fsO a.out 

will print 


f.c: 

identification information 

f.o: 

identification information 

a.out; 

identification information 


Whet is intended to be used in conjunction with the SCCS command get{l), which automatically 
inserts identifying information, but it can also be used where the information is inserted manu¬ 
ally. 

SEE ALSO 

sccsfl), get(l), help(l), file(l). 

The Source Code Control System in Programming Toots for the Sun System 

DIAGNOSTICS 

Use help{l) tot explanations. 

BUGS 

It’s possible that an unintended occurrence of the pattern Q(#) could be found just by chance, 
but this causes no harm in nearly all cases. 
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NAME 

whatis - describe what a command is 

SYNOPSIS 

whatis command 

DESCRIPTION 

Whtttia looks up a given command and displays the header line from the manual section. You can 
then run the man(l) command to get more information. If the line starts ‘name(section).. . you 
can do man section name to get the documentation for. it. Try whatis ed and then you 
should do man 1 ed to get the manual page for ed. 

Whatio is actually just the —f option to the nuin(l) command. 

FILES 

/usr/lib/whatis Data base 

SEEALSO 

man(l), catman(8) 
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NAME 

whereis - locate source, binary, and/or manual for program 
SYNOPSIS 

wherein [ -ebm | | -u ] (-SBM dir ... -f ] name ... 

DESCRIPTION 

Whertit locates source/binary and manuals sections for specified files. The supplied names are 
first stripped of leading pathname components and any (single) trailing extension of the form .ext, 
for example, »c. Prefixes of a. resulting from use of source code control are also dealt with. 
Whereia then attempts to locate the desired program in a list of standard places. 

OPTIONS 

-b Search only for binaries. 

-a Search onfy for sources. 

-m Search only for manual sections. 

Search for unusual entries. A file is said to be unusual if it does not have one entry of 
each requested type. Thus whereb -m -u * asks i'or those files in the current direc* 
tory which have no documentation. 

-B Change or otherwise limit the places where wkereia searches for binaries. 

-M Change or otherwise limit the places where whereia searches for manual sections. 

-S Change or othervrise limit the places where whereia searches for sources. 

-f Terminates the last directory list and signals the start of file names, and must be used 

when any of the -B, -M, or -S options are used. 

EXAMPLE 

Find all files in fuarfbin wiiich are not documented in /uar/man/manl with source in 
/uar/are/cmd: 

angel% ed /usr/ucb 

angel% whereis —u —M /usr/man/manl -S /usr/src/emd -f * 


Pn.,ES 

\ /usr/src/* 

/u8r/{doc,man}/* 

/lib, /etc, /usr/(lib,bin,ucb,old,new,local} 

BUGS 

Since whereia uses chdir{2) to run faster, pathnames given with the -M, -S, or -B must be full; 
that is, they must begin with a ‘/\ 


i 


O 
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NAME 

which - locate a program file including aliases auid paths {esh only) 

SYNOPSIS 

which ( name ) ••• 

DESCRIPTION 

Which takes a list of names and looks for the files which would be executed had these names been 
given as commands. Each argument is expanded if it is aliased, and searched for along the user’s 
path. Both aliases and path are taken from the user’s .cshrc file. 

FILES 

"/.cshrc source of aliases and path values 

DIAGNOSTICS 

A diagnostic is given for names which are aliased to more than a single word, or if an executable 
file with the argument name was not found in the path. 

BUGS 

Only aliases and paths from "/.cshrc are used; importing from the current environment is not 
attempted. Must be executed by a csh, since only csh’s know about aliases. 
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NAME 

who - who is on the system 
SYNOPSIS 

who I who-file ] ( am i ] 

DESCRIPTION 

Used without arguments, who lists the login name, terminal name, and login time for each current 
UNIX user. Who gets this information from the /etcfulmp file. 

If a filename argument is given, the named file is examined instead of letcfutmp. Typically the 
named file is f usrjadmjwtmp, which contains a record of all logins since it was created. In this 
case, who lists logins, logouts, and crashes. Each login is listed with user name, terminal name 
(with ‘Idevf* suppressed), and date and time. Logouts produce a similar line without a user 

name. Reboots produce a line with in place of the device name, and a fossil time indicating 

when the ^stem went down. Finally, the adjacent pair of entries '|' and indicate the system- 
maintained time just before and after a date command changed the system’s idea of the time. 

With two arguments, as in 'who am i’ (and also 'who are you’), who telk who you are logged in 
as: it displays your hostname, login name, terminal name, and login time. 

EXAMPLES 

angel% who am 1 

angelihenty ttypO Apr 27 11:24 

angel% 

krypton% who 
mktg ttymO Apr 27 11:11 

shannon ttypO Apr 27 11:25 

henry ttypl Apr 27 11:30 

ktypton% 

FILES 

/etc/utmp 
SEE ALSO 

whoami(l), getuid(2), utmp(5), w(l) 
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NAME 

whoami - display effective current username 

SYNOPSIS 

whoami 

DESCRIPTION 

Whoawi displays the username of whoever is currently logged in. Whoami works even if you are 
logged in as the super-user, while 'who am i’ does not since it gets its information from the 
Jete/utmp file. 

FILES 

/etc/passwd username data base 

SEE ALSO 

who(l) 
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NAME 

write - write to asother user 

SYNOPSIS 

write user (ttyname ] 

DESCRIPTION 

Write copies lines from your standard input to user’s screen. 

When you type a write command, the person you’re writing to sees a message like this: 

Message from hostnamelyourname on yourttyname at hh:mm ... 

After typing the write command, enter the text of your message. What you type appears line- 
by-line on the other user’s screen. Conclude by typing an end of file indication (‘D) or an inter¬ 
rupt. At this point write displays ‘EOT’ on your recipient’s screen and exits. 

To write to a user who is logged in more than once, use the ttyname argument to indicate the 
appropriate terminal name. 

You can grant or deny other users permission to write to you by using the meeg command 
(default allows writing). Certain commands, nroffasA pr(l) in particular, don’t allow anyone to 
write to you while you are using them in order to prevent messy output. 

If write finds the character '!’ at the beginning of a line, it calls the shell to execute the rest of the 
line as a command. 

Two people can carry on a conversation by wrtle’lng to each other. When the other person 
receives the message indicating you are writing to him, he can then write back to you if he 
wishes. However, since you are now simultaneously typing and receiving messages, you end up 
with garbage on your screen unless you work out some sort of scheduling scheme with your 
partner. You might try the following conventional protocol: when you first write to another user, 
wait for him to write back before starting to send. Each person should end each message with a 
distinctive signal — -o- (for ‘over’) is standard — so that the other knows when to begin a reply. 
To end your conversation, type -oo- (for 'over and out’) before finishing the conversation. 

EXAMPLE 

Here is an example of a short dialog between two people on different terminals. Two users called 
Horace and Eudora are logged in on a system called jones. To illustrate the process, both users’ 
screens are shown side-by-side: 

Eudora’s Terminal Horace’s Terminal 

Horace is staring at kis screen 
Message from jonesleudora on tty09 at 17:05 ... 
how about a squash game tonight? -o- 
jones% write eudore 

I*m playing tiddly winks with Carmellne -o- 


How about the beach on Sunday? -o- 
Sorry, I'm washing my tent that day -o- 

See you when I get back from Peru -oo- 

EOF 

I hear rack of llama Is very tasty -oo- 
‘D 

jones% 


jones% write horaee 

how about a squash gams tonight? -o- 


Message from jonesihorace on tty03 at 17:06 ... 
I’m playing tiddlywinks with Carmeline -o- 
How about the beach on Sunday? -o- 

Sorry, I’m washing my tent that day -o- 

See you when I get back from Peru -oo- 
‘D 

jones% 


I hear rack of llama is very tasty -oo- 
EOF 
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FILES 

/etc/utmp 

/bin/sh 

SEE ALSO 

ine8g(l), who(l), mail(l), ialk(l) 


to find U5er 
to execute ‘1’ 
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XSEND(l) 


NAME 

xsend, xget, enroll - secret mail 

SYNOPSIS 

xsend ueemame 

xget 

enroll 

DESCRIPTION 

These commands implement a secure communication channel; the channel is like mail{l), but no 
one can read the messages except the intended recipient. The method embodies a public-key 
cryptosystem using knapsacks. 

To receive messages, use enroll; it asks you for a password that you must subsequently quote in 
order to receive secret mail. 

To receive secret mail, use xget. It asks for your password, then gives you the messages. 

To send secret mail, use xsend in the same manner as the ordinary mail command. Unlike mail, 
xsend accepts only one target. A message announcing the receipt of secret mail is also sent by 
ordinary maQ. 

FILES 

/usr/spool/secretmail/*.key keys 
/usr/Bpool/secretmail/*.[0-9| messages 

SEE ALSO 

mail (1) 

BUGS 

The knapsack public-key cryptosystem is known to be breakable. 

RESTRICTIONS 

These facilities are not available on software shipped outside the U.S. 
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NAME 

xstr - extract strings from C programs to implement shared strings 
SYNOPSIS 

xstr ( -V ) (-c 11 - ] ( file ) 

DESCRIPTION 

Xstr maintains a file called etringa into which strings in component parts of a large program are 
hashed. These strings are replaced with references to this common area. This serves to imple* 
ment shared constant strings, most useful if they are also read-only. 

The command 

xstr --e name 

extracts the strings from the C source in name, replacing string references by expressions of the 
form (&xstr[number]) for some number. An appropriate declaration of satr is prepended to the 
file. The resulting C text is placed in the file z.c, to then be compiled. The strings from this file 
are placed in the atringa data base if they are not there already. Repeated strings and strings 
which are suffixes of existing strings do not cause changes to the data base. 

After ail components of a large program have been compiled a file xs.c declaring the common xatr 
space can be created by a command of the form 

xstr 

This xax file should then be compiled and loaded with the rest of the program. If possible, the 
array can be made read-only (shared) saving space and swap overhead. 

Xatr can also be used on a single file. A command 
xstr name 

creates files z.c and xa.c as before, without using or affecting any atringa file in the same directory. 

It may be useful to run xatr after the C preprocessor if any macro definitions yield strings or if 
there is conditional code which contains strings which may not, in fact, be needed. Xstr reads 
from its standard input when the argument is given. An appropriate command sequence for 
running xatr after the C preprocessor is: 

ce -E name.c | xstr ^ 
cc -c x.c 
mv x.o name.o 

Xatr does not touch the file atringa unless new items are added, thus make can avoid remaking 
xa.o unless truly necessary. 

OPTIONS 

-c file Take C source text from file. 

-V Verbose: display a progress report indicating where new or duplicate strings were found. 

FILES 

strings Data base of strings 

x.c Massaged C source 

xs.c C source for definition of array 'xstr’ 

/tmp/xs* Temp file when 'xstr name’ doesn’t touch atringa 

SEE ALSO 

mkstr(l) 

BUGS 

If a string is a suffix of another string in the data base, but the shorter string is seen first by xatr 
both strings will be placed in the data base, when just placing the longer one there will do. 
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NAME 

yaee - yet another compiler-compiler 

SYNOPSIS 

yaee (-vd ] grammar 

DESCRIPTION 

Yaee converts a context-free grammar into a set of tables for a simple automaton which executes 
an LR(1) parsing algorithm. The grammar may be ambiguous; specified precedence rules are used 
to break ambiguities. 

The output file, must be compiled by the C compiler to produce a program yyparee. This 

program must be loaded with the lexical analyser program, yylex, as well as main and yyerror, an 
error handling routine. These routines must be supplied by the user; tex{l) is useful for creating 
lexical analyzers usable by yaee. 

OPTIONS 

-V Prepare the file y.eutput containing a description of the parsing tables and a report on 
confiicts generated by ambiguities in the grammar. 

-d Generate the file y.tab.k with the define statements that associate the yaeo-assigned ‘token 
codes’ with the user-declared ‘token names'. This allows source files other than y.tab.e to 
access the token codes. 

FILES 

y.output 

y.tab.e 

y.tab.h defines for token names 

yacc.tmp, yacc.acts temporary files 
/usr/lib/yacepar parser prototype for C programs 

SEE ALSO 
tex{l) 

LR Parting by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. 

Yaee — Yet Another Compiler Compiler in 
Programming Tooltfor the Sun Worketation. 

DIAGNOSTICS 

The number of reduce-reduce and shift-reduce confiicts is reported on the standard output; a more 
detailed report is found in the y.output file. Similarly, if some roles are not reachable from the 
start symbol, this is also reported. 

BUGS 

Because file names are fixed, at most one yaee process can be active in a given directory at a 
time. 
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NAME 

yes - be repetitively affirmative 

SYNOPSIS 

yes I expletive ] 

DESCRIPTION 

Yes repeatedly outputs “y”, or if expletive is given, that is output repeatedly. Termination is by 
typing an interrupt character. 
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NAME 

r^trepl - magaify a raster image by 2 times 

SYNOPSW 

rfitrepl 

DESCRIRPON 

Raetrepl reads a file in rasterfile format (see lufrfineludefrasterfile.k) on the standard standard 
input, replicates each bit in both the x and y directions, and writes the resulting rasterfile to stan- 
dajfd output. 

EXAMPLES 

tutorial% ■crMndump | raatrepl | Ipr -l^erMtee -v 

sends a rasterfile containing tiie current frame buffer to the lineprinter, doubling the site of the 
image so that it fills a single page. 

SEE ALSO 

sereendutnt>(l), 8creenload(l), lpr(l) 
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NAME 

screendump - dump frame buffer image 
SYNOPSIS 

•ereendump (-«] {-f dUplaj/ 1 
DESCRIPTION 

Screendump reads out the contents of the console frame buffer (Idev/fb) on any model of Sun 
Workstation and outputs the display image in Sun standard rasterfile format (see 
jutr!include!ratterfile.K) standard output. 

By default, ecreendump attempts first to output the contents of the console frame buffer. If no 
console frame buffer is found, ecreendump attempts to output the contents of a color frame buffer. 
The -t option selects a color frame buffer directly. Heuristics are applied to locate the color 
frame buffer the user is most likely interested in. Hie -f option explicitly sets the name of the 
desired frame buffer device. 

The utility program teretnload displays Sun standard rasterfiles on an appropriate Sun Worksta* 
tion monitor. Output filters exist for printing standard monochrome rasterfiles on Versatec V-80 
electrostatic plotters. 

OPTIONS 

-e Dump a color frame buffer without trying the console frame buffer. 

-f display 

Use display as the device name of the display. 

EXAMPLIPS 

tutorial^ screendump >save.thlsJmnge 
writes the current contents of the console frame buffer into the file save.this.image. 

tutorial^ screendump -f /dev/cgoneO >8nvexolor.Image 

writes the current contents of the frame buffer jdevjegoneO into the file save.eolor.image. This 
has the same effect as the -c option for the most common display configuration. 

tutorial% screendump | Ipr -Pversatee -v 

sends a rasterfile containing the current frame buffer to the lineprinter, selecting the printer 
named "versatec" and the "v" output filter (see fetelprinteap). 

FILES 

/ityffb Default name of console display frame buffer. 

/dev/cgoneO Default name of the Sun«l color display frame buffer. 

SEE ALSO 

screenload(l), Ipr(l) 
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NAME 

sereenload - restore frame buffer image 
SYNOPSIS 

aereenlead j -d ) ( -f dUptay ) (-linrfe* 1 ( -b 1 | -g 1 (-w) | -h# (#### (...HI I fll«) 
DESCRIPTION 

Sereentoad accepts input in Sun standard rasterfile format (see fusrfineludelratttrJUe.h) and 
attempts to display the input on the appropriate monitor (monochrome or color). Sereenload nor* 
mally displays rasterfiles on the console display, but displays them on some heuristically deter* 
mined color display if it finds no console display. Sereentoad displays color rasterfiles only on a 
color monitor. Sereenload is able to display monochrome rasters on a color display. 

If the dimension! of the image contained in the input data are smaller than the actual resolution 
of the display (e.g. loading a 1024-by'800 Stin*l image on a 1152-by-900 Sun-2 display), screen- 
toad centers the image on the actual workstation screen and fills the border area with solid black 
(by default). Various options m^ be used to change the fill patterd. 

If the dimensions ol* the image contained in t&e input data are larger than the actual resolution of 
the display, sereenlcsd clips the right and bottom edges of the input image. 

If there is an option^ filename argument, eereenioad reads its input data from that file. If no 
filename argument is given, aereentoad reads its input data from the standard input. 

The utility program oereendump creates Sun standard rasterfiles from the display on a Sun 
Workstation monitor. 

OPTIONS 

-d Verify that display dimensions and input data image dimensions match, and print warn¬ 
ing messages if they do not. 

-f ditplay 

Use ditplay as the name of the frame buffer device. 

-lindex If the image is smaller tkan the display, use index (0 <— index < 256) as the index 
value into the color map for the foreground color of the border fill pattern. The default 
index value is 255. 

If the input data dimensions are smaller than the display dimensions, fill the border with 
a pattern of solid ones (default). On a monochrome display this results in a black border; 
on a color display the color map value selected by the -1 option determines the border 
color. , 

If th^ infiut data dimensions are smaller than the display dimensions, fill the border with 
a pattern of ‘^desktop grey". On a monochrome display this results in a border matching 
the backglound pattern used by the SunWindows system; on a color display the color 
map value selected by the -1 option detemines the foreground border color, though the 
pattern is the same as on a monochrome display. 

If the input data dimensions are smaller than the displa^ dimensions, fill the border with 
a pattern of solid teros. On a monochrome display this results in a white border; on a 
color display the color map value at index 0 determines the border color. 

If the input d^a dimension! hre smaller than the display dimensions, fill the border with 
the bit pattern described by the following # 16-bit hexadecimal constants. Note that a 
"1" bit is black and a "0” bit is white on the monochrome display; on a color diplay the 
color map value selected by the i" option determines the border foreground color. The 
number of hex constants in the pattern is limited to 16. 

EXAMPLES 

tutorial^ sereenload saved-dlsplay.Image 

reloads the raster image contained in the file eaved.ditplay.image on the display type indicated by 
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the rasterfile header in that file. 

tutoriaI% aereenload —f/dev/egoneO monoehroine.lmage 
reloads the raster image in the file monoehrome.imige on the frame buffer device jdevjegoneO. 

tutorial% screenload -hi fflT ■un.l^aved.lnastge 
is equivalent to the —b option (fill border with black), while 

tutorial% aereenload -h4 8888 8888 8888 8888 Bun.lMvadJmage 
is equivalent to the -g option (fill border with desktop grey).. 

FILES 

/dev/fb Default name of console display frame buffer 

/dev/egoneO Default name of SUn-1 color display frame buffer 

SEE ALSO 

screendump(l) 
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NAME 

vfontiDfo - inspect and print out information about UNCC fonts 
SYNOPSIS 

vfontlnfo (-V) fontname | characters | 

DESCRIPTION 

Vfontinfo displays information about fonts in the UNIX format. Vfontinfo displays all the inform 
mation in the font header and information about every non-null (width > 0) glyph. This can be 
used to make sure the font is consistent with the format. Vfontinfo displays the information on 
the standard output. 

The optional arguments are as follows: 

fontname is the name of the font you wish to inspect. If it can’t find the file in your working 
directory, vfontinfo looks in futrfUbfvfont (the place most of the fonts are kept). 

ekaraetere specify cert^ characters to show. If omitted, the entire font is shown. 

OPTIONS 

-V display the bits of the g^ph itself as an array of X’s and spaces, in addition to the header 
information. 

SEE ALSO 

vfont(5) 


Sun Release 1.1 


Last change: 5 April 1984 


1 



yTROFF(l) 


USER COMMANDS 


VTROFF(l) 


NAME 

vtroff - trofl to a raster plotter 
SYNOPSIS 

vtroff ( -w ] I -F majorfont ] [ -1S3 minor/ont | { -ilength ] [ -x ] troff arguments 

DESCRIPTION ' ' '3 

Vtroff runs troff{l) sending its output through various programs to produce typeset output on a 
raster plotter such as a Ben8on>Varian ot jot n^yersatec, « 

OPTIONS 

-W use a wide output device; the defauIt.ja:tQ-ui^ %p|iTow device. 

is;^- 

-Ilength 

(lower case ell) split the output onto successive pages every length inches rather than the 
.j, default y inches^. 

-Vmojorfont /’ " \ . 

specify majorfont as the font'to U8(6 iyteall dibf^lt H^rsfiey font. This places nor* 
mal, italic and bold vernons of majorfont on font positions 1, 2, and 3. 

-n minorfont 

place a font specified by minorfont only on a single position sp^ifi^ed by n, where n is 1, 
2, or-3. V3rc#8dds a.rt&thermnor^fpntiy^neif n^ed/. Thus 

tttto|ial% ytroff-n^ pnp^r , - 

K* Ml) aet a paper ij^thf^ffers^y font, while* r ;-, 

•V , a ^.®*9?M%'ytroff-F nohlo-kBi'pnip*- 
will set'the paper'm the‘(sans 8ei^)%ontcfdnt.>;.T i/. , 

-X . exactly simulate photo^tj^esette^ output -^ tby is,':unhgUhe width‘tables for the C/A/T 
photo-ty'pesetter. ' I;- , ,«•. ^ 


FILES 




/ttst/lib/tmac/tmaciv'cat defaultifottt ;^ttn^ and h^,|ia^ 

/usr/lib/fontinfo/* ■ , fixes for. other fonts \ _ • 

/usr/lib/vfont-- , directory cpn^aihing fonts^^/" v:- : ^ 

SEE ALSO ■' '■ ^ 

troff(l), vfont(6), vpr(l) ->1 v>f 

BUQ8 

Since some macro packages work correPt^'-dnly if'thC'fonts namedJt; 1^ B, and S are mounted, 
and since the Versatec fonts have Afferent widths for indiyidoal characters than the fonts found 
on the typesetter, the following dodge is necessary: If you^don’t,use the troff Jp directive, you 
get the widths of the standard typesetter fonts for the C/A/T*. If, however, you remount the R, 
I, B and S fonts, you get the width tables for the Versatec. 
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VWIDTH(l) 


USER COMMANDS 


VWK)TH(l) 


NAME 

vwidtb - maJce troff width table for a font 
SYNOPSIS 

vwldth fontflle pointsize > ttxxx 
ee -c ttxM 

mv ttxxM /uar/Ub/font/ftax 
DESCRIPTION 

Vwidtk translates from the width information stored in the vfont style format to the format 
expected by troff. Treif wants an object file in a.ott((5) format — this fact does not seem to be 
documented anywhere in the troff manuals. Troff should look directly in the font file but it 
doesn’t. 

It is not necessary to use vwidth unless you have made a change that would affect the width 
tables. Such changes include numerically editing the width field, adding a new character, and 
moving or copying a character to a new position. It is not always necessary to use vwidth if the 
physical width of the glyph (that is, the number of columns in the bit matrix) has changed, but if 
it has changed much the logical width should probably be changed and vwidth run. 

Vwidth produces a C program on its standard output. This program should be run through the C 
compiler and the object (that is, the *0 file) saved. Th^ resulting file should be placed in 
lutrilibl/ont in the file thxf where xx is a one or two letter code that is the logical (internal to 
troff) font name. This namift can be found by looking in t'^.e file /usr/lib/fontinfo//name* where 
/name is the external name of the font. 

SEE ALSO 

vfont(6), troff(l), 

BUGS 

Produces the C file using obsolete syntax that the portable C compiler complains about. 
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ADVENTURE(6) 


GAMES AND DEMOS 


ADVENTURE(6) 



NAME 

adventure - an exploration game 
SYNOPSIS 

/|isr/games/adveature 

DESCRIPTION 

The object of the game is to locate and explore Colossal Cave, find the treasures hidden there, 
and bring them back to the building with you. The program is self-describing to a point, but part 
Cjf the game is to discover its rules. 

terminate a game, type ‘quit’; to save a game for later resumption, type ‘suspend’. 

BUGS 

Saving a game creates a large executable file instead of just the information needed to resume the 
game. 


o 


o 
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ARITHMETIC(6) 


GAMES AND DEMOS 


ARITHMETIC (6) 


NAME 

arithmetic - provide drill in number facts 
SYNOPSIS 

/usr/games/arithmetle { +*x/ | { range ] 

DESCRIPTION 

Arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the 
answer is correct, it types back “RightP*, and a new problem. If the answer is wrong, it replies 
**What?”, and waits for another answer. Every twenty problems, it publishes statistics on 
correctness and the time required to answer. 

To quit the program, type an interrupt (delete). 

The first optional argument determines the kind of problem to be generated; +-x/ respectively 
cause addition, subtraction, multiplication, and division problems to be generated. One or more 
characters can be given; if more than one is given, the different types of problems will be mixed in 
random order; default is H— 

Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and 
quotients will be less than or equal to the value of range. Default range is 10. 

At the start, all numbers less than or equal to range are equally likely to appear. If the respon¬ 
dent makes a mistake, the numbers in the problem which wsts missed become more likely to reap¬ 
pear. 

As a matter of educational philosophy, the program will not give correct answers, since the 
learner should, in principle, be able to calculate them. Thus the program is intended to provide 
drill for someone just past the first learning stage, not to teach number facts de novo. For almost 
all users, the relevant statistic should be time per problem, not percent correct. 
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GAMES AND DEMOS 


BACKGAMMON(6) 


NAME 

backgammon - the game of backgammon 


SYNOPSIS 

backgammon ( - | [ n r w b pr pw pb t^erm ^JUt ) 


DESCRIPTION 

Backgammon lets you play backgammon against the computer or against a Triend*. All com¬ 
mands only are one letteri so you don’t need to type a carriage return, except at the end of a 
move. Backgammon is mostly self documenting, so that a question mark (?) will usually get some 
help. If you answer V when backgammon asks if you want the rules, you will get text explaining 
the rules of the game, some hints on strategy, instruction on how to use backgammon, and a 
tutorial consisting of a practice game against the computer. A description of how to use backgam¬ 
mon can be obtained by answering ‘y’ when it asks if you want instructions. The possible argu¬ 
ments for backgammon (most ar^ unnecesary but some are very convenient) consist of: 

n don’t ask for rules or instructions 
r player is red (implies n) 
w player is white (implies n) 
b two players, red and white (implies n) 
pr print the board before red’s turn 
pw print the board before white’s turn 
pb print the board before both player’s turn 

tterm terminal is type term, uses /eic/termcap, otherwise uses the TERM environment variable. 

aflle recover previously saved game from file. This can also be done by executing the saved 
file, that is, typing its name in as a command. 


Aiguments may be optionally preceded by a - sign. Several arguments may be concatenated 
together, but not after ‘s’ or ‘t’ arguments, since they can be followed by an arbitrary string. Any 
unrecognized arguments are ignored. An argument of a lone - gets a description of possible argu¬ 
ments. 


If term has capabilities for direct cursor movement, backgammon ‘fixes’ the board after each 
move, so the board does not need to be reprinted, unless the screen suffers some horrendous 
malady. Also, any ‘p’ option will be ignored. 

QUICK REFERENCE 

When backgammon prompts by typing only your color, type a space or carriage return to roll, or 
d to double 

p io print the board 

q > to quit 

■ to save the game for later 

When backgammon prompts with ’Move:’, type 

p to print the board 

q to quit 

a to save the game 

or a move, which is a sequence of 

art move from s to f 

a/r move one man on a the roll r separated by commas or spaces and ending with a newline. 
AvaUable abbi^eviations are 
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BACKGAMM0N(6) 


GAMES AND DEMOS 


BACKGAMMON(6) 


■-fl’fS means 
«/rlr2 means 8/rl,8/r2 

Use 'b’ for bar and ‘h’ for home, or 0 or 25 as appropriate. 

FILES 

/usr/games/teachgammon rules and tutorial 
/etc/termcap terminal capabilities 

BUGS 

B,ackgammon*8 strategy needs much work. 
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GAMES AND DEMOS 


BANNER (6) 


NAME 

banner - print large banner on printer 
SYNOPSIS 

/usr/games/banner ( -wn ] message ... 

DESCRIPTION 

Banner prints a large, high quality banner on the standard output. If the message is omitted, it 
prompts for and reads one line of its standard input. If -w is given, the output is scrunched 
down from a width of 132 to n , suitable for a narrow terminal. If n is omitted, it defaults to 80. 

The output should be printed on a hard-copy device, up to 132 columns wide, with no breaks 
between the pages. The volume is enough that you want a printer or a fast hardcopy terminal, 
but if you are patient, a decwriter or other 300 baud terminal will do. 

BUGS 

Several ASCII characters are not defined, notably <, >, (, ), \, *, _, {, }, |, and ~. Also, the 
characters ”, and & are funny looking (but in a useful way.) 

The —vr option is implemented by skipping some rows and columns. The smaller it gets, the 
grainier the output. Sometimes it runs letters together. 


o 


o 



Sun Release 1*1 


Last change: 24 October 1983 


5 








BCD (6) 


GAMES AND DEMOS 


BCD(6) 


NAME 

bed - convert to antique media 
SYNOPSIS 

/unr/gamea/bed text 
DESCRIPTION 

Bed converts the literal text into a form familiar to old-timers. 

SEE ALSO 
dd(l) 


6 


Last change; 1 February 1983 


Sun Release 1.1 




BDEMOS(6) 


GAMES AND DEMOS 


BDEMOS(6) 


NAME 

bdemos demonstrate Sun Monochrome Bitmap Display 

SYNOPSIS 

/uar/demo/bbaUs 

/uBr/demo/bboiineo 

/usr/demo/bdemos 

/usr/demo/bjump 

/usr/demo/bphoto file 

/uBr/demo/brotcube 

DESCRIPTION 

BdetnoB is a collection of simple demonstration programs for the Sun Monochrome Bitmap 
Display. Each program is briefly described below. Unless otherwise noted, each program should 
be terminated by typing the appropriate key (usually delete or "C) to generate an interrupt sig¬ 
nal. 

bballs colliding balls demo 
bbounco bouncing square demo 
bdemoa a collection of demos 

This program has a menu for selection of several different demos. After typing a key 
to select a particular demo, the user may type "C to get back the menu. Type 'q’ to 
quit. 

bjump simulated jump to hyperspace 
bphoto JUt 

dither monochrome image file to bitmap display 

Image flies suitable for display by this program are in fusrfdemof bwpix. 
brotcube black and white spinning cube 

FILES 

/usr/demo/bwpix 

SEE ALSO 

draw(6) 
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GAMES AND DEMOS 


BOGGLE(6) 


NAME 

boggle - play the game of boggle 
SYNOPSIS 

/uar/gamcs/bog^e ( + ) ( ++) 

DESCRIPTION 

This program is intended for people wishing to sharpen their skills at Boggle (TM Parker Bros.). 
If you invoke the program with 4 arguments of 4 letters each, {e.g. “boggle appl eple moth 
erhd”) the program forms the obvious Boggle grid and lists all the words from /usr/diet/worda 
found therein. If you invoke the program without arguments, it wiU generate a board for you, let 
you enter words for 3 minutes, and then tell you how well you did relative to /uar/dlet/words. 

The object of Boggle is to find, within 3 minutes, as many words as possible in a 4 by 4 grid of 
letters. Words may be formed from any sequence of 3 or more adjacent letters in the grid. The 
letters may join horizontally, vertically, or diagonally. However, no position in the grid may be 
used more than once within any one word. In competitive play amongst humans, each player is 
given credit for those of his words which no other player has found. 

In interactive play, enter your words separated by spaces, tabs, or newlines. A bell will ring when 
there is 2:00, 1:00, 0:10, 0:02, 0:01, and 0:00 time left. You may complete any word started before 
the expiration of time. You can surrender before time is up by bitting ’break’. While entering 
words, your erase character is only effective within the current word and your line kill character is 
ignored. 

Advanced players may wish to invoke the program with 1 or 2 + ’s as the first argument. The 
first + removes the restriction that positions can only be used once in each word. The second + 
causes a position to be considered adjacent to itself as well as its (up to) 8 neighbors. 
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NAME 

bsuncube - view 3-D Sun logo 
SYNOPSIS 

/usr/demo/bauneube 

DESCRIPTION 

Beuneube allows the user to view a cube from various positions with hidden faces removed. The 
faces of the cube consist of the Sun logo. The viewing position is selected using the mouse. Using 
the SunCore Gr^hics Package, a 3-D projection is drawn on the Sun Monochrome Bitmap 
Display. 

The program operates in two modes; DisplayObject mode and SelectView mode. The program 
starts in DisplayObject mode. 

DinpUyObJeet: The cube is displayed in 3-D perspective with hidden faces removed. Type "q” 
while in this mode to exit the program. Hit mouse button 3 to switch to SelectView mode. 

SelectView: Schematic projections of the outline of the cube are shown and the mouse is used to 
select a viewing position. Use button 1 to set x and button 2 to set y in the Front View. Use 
button 2 to set z in the Top View. Hit button 3 to switch to DisplayObject mode. 

The view shown in DisplayObject mode is drawn using the conventions that the viewer is always 
looking from the viewing position toward the center of the cube and that the positive y axis on 
the screen is the projection of the positive y axis in 3-D cube coordinates. 
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GAMES AND DEMOS 


CANFIELD (6) 


NAME 

canfleld, cfscores ~ the solitaire card game canfield 
SYNOPSIS 

/uBr/games/eanfield 
/usr/games/cfscor es 

DESCRIPTION 

If you have never played solitaire before, it is recommended that you consult a solitaire instruc¬ 
tion book. In Canfield, tableau cards may be built on each other downward in alternate colors. An 
entire pile must be moved as a unit in building. Top cards of the piles are avaUable to be able to 
be played on foundations, but never into empty spaces. 

Spaces must be filled from the stock. The top card of the stock ako is available to be played on 
foundations or built on tableau piles. After the stock is exhausted, tableau spaces may be filled 
from the talon and the player may keep them open until he wishes to use them. 

Cards are dealt from the hand to the talon by threes and this repeats until there are no more 
cards in the hand or the player quits. To have cards dealt onto the talon the player types ’ht’ for 
his move. Foundation base cards are ako automatically moved to the foundation when they 
become available. 

The command ’c* causes canfield t6 maintain card counting statistics on the bottom of the screen. 
When properly used this can greatly increase ones chances of winning. 

The rules for betting are somewhat less strict than those used in the official version of the game. 
The initial deal costs $13. You may quit at thk point or inspect the game. Inspection costs $13 
and allows you to make as many moves as is possible without moving any cards from your hand 
to the talon, (the initial deal places three cards on the talon; if all these cards are used, three 
more are made available.) Finally, if the game seems interesting, you must pay the final install¬ 
ment of $26. At this point you are credited at the rate of $5 for each card on the foundation; as 
the game progresses you are credited with $5 for each card that is moved to the foundation. Each 
run through the hand after the first costs $5. The card counting feature costs $1 for each unk¬ 
nown card that is identified. If the information is toggled on, you are only charged for cards that 
became visible since it was last turned on. Thus the maximum cost of information is $34. Play¬ 
ing time is charged at a rate of $1 per minute. 

With no arguments, the program cfacorea prints out the current status of your canfield account. 
If a user name is specified, it prints out the status of their canfield account. If the —a flag is 
specified, it prints out the canfield accounts for all users that have played the game since the 
database was set up. 

FILES 

/usr/games/canfleld tbe game itself 

/usr/games/cfscores the database printer 

/usr/games/lib/cfscores the database of scores 

BUGS 

It is impossible to cheat. 
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CHASE(6) 


NAME 

chaM - Try to escape to killer robots 
SYNOPSIS 

/usr/gmm«/ehu« [ nrobot$ ] | nfenee$ ] 

DESCRIPTION 

The object of the game cbase is to move around inside of the box on the screen without getting 
eaten by the robots chasing and without running into anything. 

If a robot runs into another robot while chasing you, they crash and leave a Junk heap. If a robot 
runs into a fence, it is destroyed. 

If you can survive until all the robots are destroyed, you have won! 

If you do not specify either nretot* or nftnct$, chase will prompt you for them. 
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GAMES AND DEMOS 


CHING(6) 


NAME 

ching - the book of changes and other cookies 
SYNOPSIS 

/uar/gmmcs/ching f hexagram ] 

DESCRIPTION 

The I Ching or Book of Changes is an ancient Chinese oracle that has been in use for centuries as 
a source of wisdom and advice. 

The text of the oracle (as it is sometimes known) consists of sixty-four hexagrams, each symbol¬ 
ized by a particular arrangement of six straight (—) and broken (—) lines. These lines have 
values ranging from six through nine, with the even values indicating the broken lines. 

Each hexagram consists of two major sections. The Judgement relates specifically to the matter 
at band (E.g., **It furthers one to have somewhere to go.”) while the Image describes the general 
attributes of the hexagram and how they apply to one’s own life ("Thus the superior man makes 
himself strong and untiring.”). 

When any of the lines has the value six or nine, it is a moving line; for any such line there is an 
appended judgement which becomes significant. Furthermore, the moving lines are inherently 
unstable and change into their opposites; a second hexagram (and thus an additional judgement) 
is formed. 

Normally, one consults the oracle by fixing the desired question firmly in mind and then casting a 
set of changes (lines) using yarrow-stalks or tossed coins. The resulting hexagram will be the 
answer to the question. 

Using an algorithm suggested by S. C. Johnson, the UNDC oracle simply reads a question from the 
standard input (up to an EOF) and hashes the individual characters in combination with the time 
of day, process id and any other magic numbers which happen to be lying around the system. 
The resulting value is used as the seed of a random number generator which drives a simulated 
coin-toss divination. The answer is then piped through nr off for formatting and will appear on 
the standard output. 

Fqr those who wish to remain steadfast in the old traditions, the oracle will also accept the results 
ot a personal divination using, for example, coins. To do this, cast the change and then type the 
resulting line values as an argument. 

The impatient modern may prefer to settle for Chinese cookies; try fortune{^y 
SEE ALSO 

It furthers one to see the great man. 

DIAGNOSTICS 

The great prince issues commands, 

Founds states, vests families with fiefs. 

Inferior people should not be employed. 

BUGi 

Waiting in the mud 

Brings about the arrival of the enemy. 

If one is not extremely careful. 

Somebody may come up from behind and strike him. 

Misfortune. 
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GAMES AND DEMOS 


COLORDEMOS(6) 


NAME 

eolordemot - demonstrate Sun Color Graphics Display 

SYNOPSIS 

/«wr/d«mo/cballB 

/usr/domo/edraw 

/lur/domo/epfaoto file 

/usr/damo/eplpes 

/usr/d«mo/eshowmap file 

/uar/demo/esnow 

/unr/demo/csuncubn 

/unr/demo/eaunlofo 

/uar/demo/evlal 

DESCRIPTION 

Coloriemoe is a collection of simple demonstration programs for the Sun Color Graphics Display. 
Each program is briefly described below. To exit each program, send an interrupt signal by typ* 
ing the appropriate key (usually CONTROL c). 

eballn colliding balls on color display 

edraw draw on the color display; see draw (6) for an mcplanation of how to use draw. 
ephoto fiie 

display dithered color file on color display. Files suitable tor display are in 
lutr/iemofeolorpix. 

epipw colliding pipes on color display 
enhownap/Ue 

display mi^s. Files suitable for display are in f uerj iemof eegmente. 
esBOW color kaleidoscope 
esuneuba multicolor^ Sun logo 
esunlofo shaded Sun logo 
cvlsl color vlsi tayout demo 

FILES 

/usr/demo/colorpix 

/usr/demo/segments 
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GAMES AND DEMOS 


CBIBBAGE(e) 


NAME 

cribbage - the card game cribbage 
SYNOPSIS 

/uar/games/crlbbage ( -req ] name ... 

DESCRIPTION 

Cribbage plays the card game cribbage, with cribbage playing one hand and the user the other. 
Cribbage initially asks the user if the rules of the game are needed - if so, cribbage displays the 
appropriate section from According to Hoyle with more(l). 

OPTIONS 

-e Provide an explanation of the correct score when the player makes mistakes scoring his 
hand or crib. This is especially useful for beginning players. 

—q Print a shorter form of all mess^es - this is only recommended for users who have 

played the game without specifying this option. 

-r Instead of asking the player to cut the deck, cribbage will randomly cut the deck. 
PLAYING CRIBBAGE 

Cribbage first asks the player whether he wishes to play a short game ('*once around”, to 61) or a 
long game (*'twice around”, to 121). A response of's* results in a short game, any other response 
plays a long game. 

At the start of the first game, cribbage asks the player to cut the deck to determine who gets the 
first crib. The user should respond with a number between 0 and 51, indicating how many cards 
down the deck is to be cut. The player who cuts the lower ranked card gets the first crib. If 
more than one game is played, the loser of the previous game gets the first crib in the current 
game. 

For each hand, cribbage first prints the player’s hand, whose crib it is, and then asks the player to 
discard two cards into the crib. The cards are prompted for one per line, and are typed as 
explained below. 

After discarding, cribbage cuts the deck (if it is the player’s crib) or asks the player to cut the 
deck (if it’s its crib); in the later case, the appropriate response is a number from 0 to 29 indicat¬ 
ing how far down the^ remaining 40 cards are to be cut. 

After cutting the deck, play starts with the non-dealer (the person who doesn’t have the crib) 
leading the first card. Play continues, as per cribbage, until all cards are exhausted. Cribbage 
keeps track of the scoring of all points and the total of the cards on the table. 

After play, the hands are scored. Cribbage requests the player to score his hand (and the crib, if 
it is hb) by printing out the appropriate cards (and the cut card enclosed in brackets). Play con¬ 
tinues until one player reaches the game limit (61 or 121). 

A carriage return when a numeric input is expected is equivalent to typing the lowest legal value; 
when cutting the deck thb b equivalent to choosing the top card. 

SPECIFYING CARDS 

Cards are specified as rank followed by euit. The ranks may be specified as one of a, 2, 3, 4, 6, 
6 , 7, 8, 9, t, J, q, and k, or alternatively, one of ace, two, three, four, five, six, seven, eight, 
nine, ten. Jack, queen, and king. Suits may be specified as a, h, d, and c, or alternatively as 
spades, hearts, diamonds, and clubs. A card may be specified as rank suit, or rank of suit. 
If the single letter rank and suit designations are used, the space separating the suit and rank may 
be left out. Also, if only one card of the desired rank b playable, typing the rank b sufficient. 
For example, if your hand was 2h, 4d, 5c, 6h, Jc, kd and you wanted to dbcard the king of dia¬ 
monds, you could type any of k, king, kd, k d, k of d, king d, king of d, k diamonds, 
k of diamonds, king diamonds, or king of diamonds. 
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FILES 

/usr/games/cribbage 
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GAMES AND DEMOS 


DRAW(6) 


NAME 

draw - interactive graphics drawing 

SYNOPSIS 

/uar/demo/bdraw 

/uar/demo/cdraw 

DESCRIPTION 

'I'he draw programs are menu-driven programs which use the mouse, keyboard, bitmap display 
a^pd optionally the color display to draw objects, drag them around, save them on disk, and so on. 
^draw is the draw program for the black and white display and cdraw is the program for driving 
t|iie color display. 

'Ilie main menu items are selected by moving the mouse cursor and pressing the left mouse but¬ 
ton. To redraw the display, point at the left edge of the main menu box and press the left but¬ 
ton. The main menu items are: 


[pw Seg xlate 

^ Open a new translatable segment. A segment is a collection of attributes and primi¬ 

tives (lines, text, polygons, etc,). A translatable segment may subsequently be posi¬ 
tioned: 


New Seg xform 

Open a new transformable segment. A transformable segment may subsequently be 
rotated, scaled, or positioned. 


Delete Seg 

To delete a segment, point at any primitive in the segment and press the left button. 


Lines 

Polygon 


Raster 


Text 


To add line primitives to the currently open segment, position cursor, press the left 
button, ... press right button to quit. 

To add a polygon primitive to the currently open segment, position the cursor, press 
the left button, •*« press the right button to terminate the boundary definition. 
Polygons are filled with the current fill attribute. 

To add a raster primitive to the currently open segment, position the cursor, press the 
left button to reposition the box, adjust the box by moving the mouse, press the right 
button to create tlie raster primitive comprising the boxed bitmap. A *rasterfile’ is 
also created on disk for hardcopy purposes (see lusrfincludejraeitrjUe^K). This 
‘rasterflle’ file may be spooled to a Versatec printer/plotter for hardcopy after exiting 
from the draw program. The command to do this is Ipr —v rasierflle. 

To add a text primitive to the currently open segment, position cursor, press left but¬ 
ton, type the text string at the keyboard (back space works), hit return. Text is 
drawn with the current text attributes. 


Marker To add marker primitives to the currently open segment, position cursor, press the left 
button to place marker, ... press the right button to quit. 

Position To position a segment, point at any primitive in the segment, press left button, posi¬ 
tion the segment, press right button to quit. 

Rotate To rotate a transformable segment, point at any primitive in the segment, press left 
button, move mouse to rotate, press right button to quit. 

Scale To scale a transformable segment, point at any primitive in the segment, press the left 
button, move mouse to scale in x or y, press right button to quit. 

Attributes 

This item brings up the attribute menu. To select an attribute such as text font, 
region fill texture (color), linestyle, or line width, point at the item and press the left 
button. Point at the left edge of the menu box to quit. 
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8 av« 8«s To save a segment on a disk file, point at the segment, press the left button, type the 
disk file name, hit return. 

RMtor* 8*8 

To restore a previously saved segment from disk, type file name, hit return. 

Exit Ehcit the draw program. 

BUGS 

Rasters and raster text do not scale or rotate. If segments completely overlap, only the last one 
drawn may be picked by pointing with the mouse. This also ^plies to the menu segments! 
Therefore, don’t cover them up with polygons. If the draw program is interrupted (del key) the 
‘reset’ command must be given to turn keyboard echo back on and to reset -cbreak. Therefore, 
use the Exit item in the main menu to exit the program. 


c 
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NAME 

fish - play "Go Fish” 

SYNOPSIS 

/usr/games/fish 

DESCRIPTION 

Fish plays the game of “Go Fish”, a children's card game. The object is to accumulate ‘books' of 
4 cards with the same face value. The players alternate turns; each turn begins with one player 
selecting a card from his hand, and asking the other player for all cards of that face value. If the 
other player has one or more cards of that face value in his hand, he gives them to the first 
player, and the first player makes another request. Eventually, the first player asks for a card 
which is not in the second player’s hand: he replies ‘GO FISH!’ The first player then draws a card 
from the ‘pool’ of undealt cards. If this is the card he had last requested, he draws again. When 
a book is made, either through drawing or requesting, the cards are laid down and no further 
action takes place with that face value. 

To play the comp’fiter, simply make guesses by typing a, 2, 3, 4, 5, 6, 7, 8, 9, 10, j, q, or k when 
asked. Hitting return gives you information about the size of my hand and the pool, and tells you 
about my books. Saying ‘p’ as a first guess puts you into ‘pro’ level; the default is pretty dumb. 
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NAME 

fortune - print a random, hopefully interesting, adage 
SYNOPSIS 

/uar/gaoics/fortttiM (- ) (-wslao ] 

DESCRIPTION 

Fortune with no arguments prints out a random adage. The flags mean: 

-w Waits before termination for an amount of time calculated from the number of characters in 
the message. This is useful if it is executed as part of the logout procedure to guarantee 
that the message can be read before the screen is cleared. 

-a Short messages only. 

-1 Long messages only. 

-e Choose from an alternate list of adages, often used for potentially offensive ones. 

-a Choose from either list of adages. 

FILES 

/usr/games/lib/fortuBes.dat 
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NAME 

hangman - Computer version of the game hangman 
SYNOPSIS 

/usr/games/hangman 

DESCRIPTION 

Ip hangman, the computer picks a word from the on-line word list and you must try to guess it. 
The computer keeps track of which letters have been guessed and how many wrong guesses you 
have made on the screen in a graphic fashion. 

FILES 

/usr/dict/words On-line word list 
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NAME 

mille - play Mille Boraes 
SYNOPSIS 

/uar/sames/mlUe (file | 

DESCRIPTION 

Mille plays a two-handed game reminiscent of the Parker Brother’s game of Mille Bomes with 
you. The rules are described below. If a file name is given on the command line, the game saved 
in that file is started. 

When a game is starteci up, tke bottom of the score window will contain a list of commands. 
They are: 

B Pick a card from the deck. This card is placed in the ‘P’ slot in your hand. 

D Discard a card from your hand. To indicate which card, type the number of the card in 

the hand (or “P” for the just-picked card) followed by a carriage-return or space. The 
carriage-return or space is required to allow recovery from typos which can be very 
expensive, like discarding safeties. 

U Use a card. The card is again indicated hy its number, followed by a carriage-return or 
space. 

O Toggle ordering the hand. By default off, if turned on it will sort the cards in your hand 
appropriately. This is not recommended for the impatient on slow terminals. 

Q Quit the game. This will ask for confirmation, just to be sure. Hitting <DELETE> (or 
<RUBOUT>) is equivalent. 

S Save the game in a file. If the game was started from a file, yon will be given an oppor¬ 
tunity to save it on the same file. If you don’t wish to, or you did not start from a file, 
you will be asked for the file name. If you type a carriage-return without a name, the 
save will be terminated and the game resumed. 

R Redraw the screen from scratch. The command "L (control ‘L’) will also work. 

W Toggle window type. This switches the score window between the startup window (with 
all the command names) and the end-of-game window. Using the end-of-game window 
saves time by eliminating the switch at the end of the game to show the final score. 
Recommended for hackers and other miscreants. 

If you make a misli^e, an error tnessage will be printed on the last line of the score window, and 
a bell will beep. 

At the end of each Land or game, you will be asked if you wish to play another. If not, it will ask 
you if you want to save the game. If you do, and the save is unsuccessful, play will be resumed 
as if you had said you wanted to play another hand/game. This allows you to use the “S” com¬ 
mand to reattempt the save. (The game itself is a product of Parker Brothers, Inc.) 

SEE ALSO 

curses(3!)C) 

CARDS 

Here is some useful information. The number in brackets after the card name is the number of 
that card in the deck: 
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Hazard Repair 


Safety 


Out of Gas (2] 
Flat Tire (2] 
Accident [2] 
Stop (4j 

Speed Limit [3] 


Gasoline [6] 
Spare Tire [6] 
Repairs (6) 

Go [14] 

End of Limit |6] 


Extra Tank (1] 
Puncture Proof [1) 
Driving Ace (l) 
Right of Way (1) 


25 - (101, 50 - (lOj, 75 - (lOl, 100 - (121, 200 - 14) 


RULES 

Object: The point of game is to get a total of 5000 points in several hands. Each band is a race 
to put down exactly 700 miles before your opponent does. Beyond the points gained by putting 
down milestones, there are several other ways of making points. 

Overview: The game b played with a deck of 101 cards. Diatanee cards represent a number of 
miles traveled. They come in denominations of 25, 50, 75, 100, and 200. When one b played, it 
adds that many miles to the player’s trip so far thb hand. Hazard cards are used to prevent your 
opponent from putting down Dbtance cards. With the exception of the apeed limit card, they can 
only be played if your opponent has a Oo card on top of the Battle pile. The cards are Out of 
Gao, Aeeident, Flat Tire, Speed Limit, and Stop. Remedy cards fix problenos caused by Hazard 
cards played on you by your opponent. The cards are Gasoline, Repairs, Spare Tire, End of 
Limit, and Go. Safety cards prevent your opponent from putting specific Hazard cards on you in 
the first place. They are Extra Tank, Driving Aee, Puncture Proof, and Right of Way, and there 
are only one of each in the deck. 

Board Layout: The board b split into sevend areas. Prom top to bottom, they are: SAFETY 
AREA (unlabeled): This b where the safeties will be placed as they are played. HAND: These 
are the cards in your hand. BATTLE: This b the Battle pile. All the Hazard and Remedy 
Cards are played here, except the Speed Limit and End of Limit cards. Oniy the top card is 
dbplayed, as it b the only effective one. SPEED: The Speed pile. The Speed Limit and End of 
Limit cards are played here to control the speed at which the player is allowed to put down miles. 
MUtEAGE: Miles are placed here. The total of the numbers shown here b the dbtance traveled 
so far. 

Piny: The first pick alternatll between the two players. Each turn usnaBy starts with a pick 
from the deck. The player then pl^s a card, or if thb b not possible or desirable, discards one. 
Normally, a play or discard of a single card constitutes a turn. If the card played b a safety, 
however, the same player takes another turn immediately. 

Thb repeats until one of the players reaches 700 points or the deck runs out. If someone reaches 
700, they have the option of going for an Extension, which means that the play continues until 
someone reaches 1000 miles. 

Hnaard and Reinedy Cards: Hazard Cards are played on your opponent’s Battle and Speed 
piles. Remedy Cards are used for undoing the effects of your opponent’s nastyness. 

Go (Green Light) must be the top card on your Battle pile for you to play any mileage, unless 
you have played the Right of Way card (see below). 

Stop b played on your opponent’s Go card to prevent them from playing mileage until they 
play a Go card. 

Speed Limit is played on your opponent’s Speed pile. Until they phy an End of Limit they 
can only play 25 or 50 mile cards, presuming their Go card allows them to do even that. 

End of Limit b played on your Speed pile to nullify a Speed Limit played by your opponent. 
Out of Gas b played on your opponent’s Go card. They must then play a Gasoline card, and 
then a Go card before they can play any more mileage. 

Flat Tire is played on your opponent's Go card. They must then play a Spare Tire card, and 
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then a Go card before they can play any more mileage. 

Accident is played on your opponent’s Go card. They must then play a Repairs card, and 
then a Go card before they can play any more mileage. 


Safety Cards: Safety cards prevent your opponent from playing the corresponding Hazard cards 
on you for the rest of the hand. It cancels an attack in progress, and always entitles the player to 
an extra turn. 

Right of Way prevents your opponent from playing both Stop and Speed Limit cards on you. 
It also acts as a permanent Go card for the rest of the hand, so you can play mileage as long as 
Ipere is not a Hazard card on top of your Battle pile. In this case only, your opponent can play 
Hazard cards directly on a Remedy card besides a Go card. 

Extra Tank When played, your opponent cannot play an Out of Gas on your Battle Pile. 

' Puncture Proof When played, your opponent cannot play a Flat Tire on your Battle Pile. 

Driving Ace When played, your opponent cannot play an Accident on your Battle Pile. 


Distance Cards: Distance cards are played when you have a Go card on your Battle pile, or a 
Right of Way in your Safety area and are not stopped by a Hazard Card. 'They can be played in 
any combination that totals exactly 700 miles, except that you cannot play more than two £00 
mile cards in one hand. A hand ends whenever one player gets exactly 700 miles or the deck runs 
out. In that case, play continues until neither someone reaches 700, or neither player can use any 
cards in their hand. If the trip is completed after the deck runs out, this is called Delayed Action. 


Coup Four^: This is a French fencing term for a eountei^thrust move as part of a parry to an 
opponents attack. In Mille Bornes, it is used as follows: If an opponent plays a Hazard card, and 
you have the corresponding Safety in your hand, you play it immediately, even before you draw. 
This immediately removes the Hazard card from your Battle pile, and protects you from that card 
for the rest of the game. This gives you more points (see “Scoring” below). 

Scoring: Scores are totaled at the end of each hand, whether or not anyone completed the trip. 
The terms used in the Score window have the following meanings: 

Milestones Played: Each player scores as many miles as they played before the trip ended. 
Each Safety: 100 points for each safety in the Safety area. 

All 4 Safeties: 300 points if all four safeties are played. 

Each Coup Fourd: 300 points for each Coup Fourd accomplished. 

The following bonus scores can apply only to the winning player. 

Trip Completed: 400 points bonus for completing the trip to 700 or 1000. 

Safe Trip: 300 points bonus for completing the trip without using any 200 mile cards. 
Delayed Action: 300 points bonus for finishing after the deck was exhausted. 

Extension: 200 points bonus for completing a 1000 mile trip. 

Sbut>Out: 500 points bonjiis lor completing the trip before your opponent played any mileage 
cards. ^ , . 

Runniofi totals are aim kept thh current score for each player for the hand (Hsund Total), the 
game (Overall Total), and number ol games won (Games). 
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NAME 

monop - Monopoly game 
SYNOPSIS 

/usr/games/monop ( file ] 

DESCRIPTION 

Monop u reminiscent of the Parker Brother's game Monopoly, and monitors a game between 1 to 
9 users. It is assumed that the rules of Monopoly are known. The game follows the standard 
rules, with the exception that, if a property would go up for auction and there are only two sol¬ 
vent players, no auction is held and the property remains unowned. 

The game, in effect, lends the player money, so it is possible to buy something which you cannot 
afford. However, as soon as a person goes into debt, he must ‘'fix the problem”, t.e., make him¬ 
self solvent, before play can continue. If this is not possible, the player’s property reverts to his 
debtee, either a player or the bank. A player can resign at any time to any person or the bank, 
which puts the property back on the board, unowned. 

Any time that the response to a question is a otring^ e.g., a name, place or person, you can type 
to get a list of valid answers. It is not possible to input a negative number, nor is it ever 
necessary. 

A Summary of Commands: 

quit: quit game: This allows you to quit the game. It asks you if you’re sure. 

print: print board: This prints out the current board. The columns have the following mean¬ 

ings (column headings are the same for the where, own holdings, and holdings 
commands): 

Name The first ten characters of the name of the square 
Own The number of the owner of the property. 

Price The cost of the property (if any) 

Mg This field has a in it if the property is mortgaged 

# If the property is a Utility or Railroad, this is the number of such owned by 

the owner. If the property is land, this is the number of houses on it. 

Rent Current rent on the property. If it is not owned, there is no rent. 

where: where players are: Tells you where all the players are. A **’ indicates the current 

player. 

own holdings: 

List your own holdings, i.e., money, get-out-of-jail-free cards, and property. 

holdings: holdings list: Look at anyone’s holdings. It will ask you whose holdings you wish to 
look at. When you are finished, type “done”. 

shell: shell escape: Escape to a shell. When the shell dies, the program continues where you 

left off. 

mortgage: 

mortgage property; Sets up a list of mortgageable property, and asks which you wish 
to mortgage. 

unmortgage: 

unmortgage property: Unmortgage mortgaged property, 
buy: buy houses: Sets up a list of monopolies on which you can buy houses. If there is 
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more than one, it asks you which you want to buy for. It then asks you how many for 
each piece of property, giving the current amount in parentheses after the property 
name. If you build in an unbalanced manner (a disparity of more than one house 
within the same monopoly), it asks you to re>input things. 

apll: sell houses: Sets up a list of monopolies from which you can sell houses, it operates in 

an analogous manner to iujf 

enrd: card for jail: Use a get-out^f>jaiI*free card to get out of jail. If you’re not in jail, or 

you don’t have one, it telb you so. 

pay: pay for jail: Pay $50 to get out of jail, from whence you are put on Just Visiting. 

Difficult to do if you’re not there. 

trade: This allows you to trade with another player. It asks you whom you wish to trade 

with, and then asks you what each wishes to give up. You can get a summary at the 
end, and, in all cases, it asks for confirmation of the trade before doing it. 

resign: Resign to another player or the bank. If you resign to the bank, all property reverts 

to its virgin state, and get-out^f-jail free cards revert to the deck. 

save: save game: Save the current game in a file for later pl^. You can continue play after 

saving, either by adding the file in which you saved the game after the monop com* 
mand, or by using the rettore command (see below). It will ask you which file you 
wish to save it in, and, if the file exists, confirm that you wish to overwrite it. 

restore: restore game: Read in a previously saved game from a file. It leaves the file intact. 

roll: Roll the dice and move forward to your new location. If you simply hit the 

<RETURN> key instead of a command, it is the same as typing roll. 


FILES 

/usr/games/lib/cards.pck Chance and Community Chest cards 

BUGS 

No command can be given an argument instead of a response to a query. 
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NAME 

number - convert Arabic numerals to English 
SYNOPSIS 

/usr/games/number 

DESCRIPTION 

Number copies the standard input to the standard output, changing each decimal number to a 
fully spelled out version. 
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NAME 

quit - test your knowledge 
SYNOPSIS 

/usr/gnmei/quiB ( -i file ) | -t ] ( categoryl category2 ] 

DESCRIPTION 

Quiz gives associative knowledge tests on various subjects. It asks items chosen from categoryl 
and expects answers from eategoryS. If no categories are specified, quiz gives instructions and lists 
the available categories. 

Quiz tells a correct answer whenever you type a bare newline. At the end of input, upon inter¬ 
rupt, or when questions run out, quiz reports a score and terminates. 

The -t flag specifies ‘tutorial* mode, where missed questions are repeated later, and material is 
gradually introduced as you learn. 

The -1 flag causes the named file to be substituted for the default index file. The lines of these 
files have the syntax: 

line ~ category newline | category line 
category >■ alternate | category ‘|* alternate 
alternate » empty | alternate primary 
primary * character | ‘j’ category ‘]’ | option 
option « *{’ category 

The first category on' each line of an index file names an information file. The remaining 
categories specify the order and contents of the data in each line of the information file. Informa¬ 
tion files have the same syntax. Backslash ‘\’ is used as with »h{l) to quote syntactically 
significant characters or to insert transparent newlines into a line. When either a question or its 
answer is empty, quiz will refrain from asking it. 

FILES 

/usr/games/quiz.k/*, 

BUGS 

The construct ‘ajab* doesn’t work in an information file. Use ‘a{b}’. 
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NAME 

rain - animated raindrops display 

SYNOPSIS 

/usr/games/rain 

DESCRIPTION 

Rain's display is modeled after the VAX/VMS program of the same name* The terminal has to 
be set for 9600 baud to obtain the proper effect. 

As with all programs that use termcap, the TERM environment variable must be set (and 
exported) to the type of the terminal being used. 

FILES 

/etc/termcap 
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NAME 

sail - multi-user wooden ships and iron men 

SYNOPSIS 

sail (] [ num) 

DESCRIPTION 

Sail is a computer version of Avalon Hill’s game of fighting sail originally developed by S. Craig 
Taylor. 

NOTES 

Sail is reaUy two programs in one. Each player keeps track of his own ship plus a DRIVER pro¬ 
gram is execl’d (by the first player) to keep track of the computer’s ships. 

The player is given the first available ship in a scenario and the computer takes the rest. Obvi¬ 
ously the more ships in your game, the longer the DRIVER will take to move them. If additional 
players join the game, they will be given ships and the DRIVER will have less work to do. 

HISTORICAL INFO 

Old Square Rigger’s were very maneuverable ships capable of intricate sailing. Their one main 
disadvantage was being unable to sail very close to the wind. The design of wooden ship allowed 
only for the guns to bear to the left and right sides. A few guns of small aspect (usually 6 or 9 
pounders) could point forward, but their effect would be small compared to a 68 gun broadside of 
24 pounders. The guns bear apprmimately like so: 

b - 

—0 

\ 

\ 

\ up to a range of ten (fw round shot) 

\ 

\ 

\ 
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An interesting phenomenon occurred when a broadside could fire down the length of an enemy 
ship. The shot tended to bounce along the deck and did several times more damage. This 
phenomenon was called a rake. It happened that a stern rake (firing from the stern to the bow) 
occasioned more damage than a bow rake, so that was the most desirable. 

\ 

b- 

—0 

\ 

\ Oa —• Stern rake! 

\ 

\ 

\ 

\ 

\ 

Most ships were equipped with Carronades which were very large, close range cannons. The cst- 
ronades have a range of two in this game and can considerably add to your fire-power when they 
come to bear. If the distance to the target ship is greater than 6, the guns can only fire at the 
rigging. A ship’s guns could fire a variety of ammunition. For example: 

ROUND 

Range of 10. Good for hull or rigging hits. 

DOUBLE 

Range of 1. Extra good for hull or rigging hits. Double takes two turns to load. 

CHAIN 

Range of 3. Excellent for tearing down rigging. Cannot damage hull or guns, though. 

GRAPE 

Range of 1. Devastating against enemy crews. 

When a ship has been battered into a hulk (zero hull), it has no choice but to surrender to the 
firing ship. This ceremony is called 'striking your colours.' A struck ship has a chance of explod¬ 
ing or sinking after a while. When a ship surrenders, its point value is given to the aggressor. 
When a ship is captured, twice the point value is awarded the victor. 

Normally, ships sailed into battle with greatly shortened sail to avoid excessive damage to the 
precious rigging. However, in this game the player can increase to full sails and move much faster 
if he wishes. But, all rigging hits incurred with full sails set are doubled. The direction rose 
displayed on the sample screen gives the maximum speeds possible for a specific ship at all atti¬ 
tudes to the wind. The full sail speeds are in parenthesis. 

Repairs can be made at tlie slow rate of two (hull, gun, or rigging) hits restored per three turns. 

Ships of class 3 bf greater drift when there is wind at the rate of one 'square' per turn. Ships of 
the Line drift one 'square' every other turn. 

INSTRUCTIONS 

Sail follows the Avalon Hill advanced rules very closely using the optional rules for ’exploding 
ships’, ’full sails’, and some others. A few unique commands have been added which seemed to be 
helpful on the reduced screen, ’i’ is such a command. 

Boarding had to go through a major revision. To prevent immediate capture of an unprepared 
crew (fouling is often not reported until after boarding has commenced) the boarded ship 
automatically fights defensively (at a small disadvantage) if no DBF’s have been prepared. 
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Th« Order of Pl»y has been eliminated for the player, but the DRIVER still abides by it. 

The commands for the player were designed to be as intelligent as possible to save typing. Some 
of the nuances I developed should be explained. 

Your prompt 

The others I will illustrafte with examples. 


move(3, 2): rll _ /* 3 movements max, of which two 

may be 45’ turns. */ 

move(3,’2): Irl /* 3 movements max of which two may 

be 45’turns, but the ship must 
move ahead before turning (there 
is a loss of headway after 
drifting) */ 

move(0,’0); r /* You can always make one turn 

even when you can’t move straight 
ahead. */ 

If you are grqtpled, fouled, or out of crew, you cannot move of course. 
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COMMANDS 

T Fire broadsides if they bear 
’r Reload 

’m’ Move (see above & below) 

’i’ Ask lookout for closest ship 
T Ask lookout for closest enemy ship 
*s’ Send a message around the fleet 
’b’ Attempt to board an enemy ship 
’L’ Unload broadsides (to change ammo) 
’B’ Recall boarding parties 
*c’ Change set of sail 
’r* Repair 

’u’ Attempt to unfoul 
’g’ Grapple/ungrapple 
Redraw screen 
’q’ Quit 


SCENARIOS 
Ranger vs. Drake: 

Wind from the N, blowing a fresh breeze. 

(a) Ranger 19 gun Sloop (crack crew) (7 pts) 

(b) Drake 17 gun Sloop (crack crew) (6 pts) 

The Battle of Flamborough Head: 

Wind from the S, blowing a fresh breeze. 

This is John Paul Jones’ first famous battle. Aboard the Bonhomme Richard, he was able to 
overcome the Serapis’s greater firepower by quickly boarding her. 

(a) Bonhomme Rich 42 gun Corvette (crack crew) (11 pts) 

(b) Serapis 44 gun Frigate (crack crew) (12 pts) 

Arbuthnot and Des Touches? 

Wind from the N, blowing a gale. 


(b) America 
(b) Befford 
(b) Adamant 
(b) London 
(b) Royal Oak 
(f) Neptune 
(f) Due Bougogne 
(f) Conquerant 
(f) Provence 
(f) Romulus 

Suffren and Hughes: 

Wind from the S, 


64 gun Ship of the Line (crack crew) (20 pts) 

74 gun Ship of the Line (crack crew) (26 pts) 

50 gun Ship of the Line (crack crew) (17 pts) 
98 gun 3 Decker SOL (crack crew) {2^ pts) 

74 gun Ship of the Line (crack crew) (26 pts) 
74 gun Ship of the Line (average crew) (24 pts) 
80 gun 3 Decker SOL (average crew) (27 pts) 
74 gun Ship of the Line (average crew) (24 pts) 
64 gun Ship of the Line (average crew) (18 pts) 
44 gun Ship of the Line (average crew) (10 pts) 

blowing a fresh breeze. 


(b) Monmouth 
(b) Hero 
(b) Isis 
(b) Superb 
(b) Burford 


74 gun Ship of the Line (average crew) (24 pts) 
74 gun Ship of the Line (crack crew) (26 pts) 

50 gun Ship of the Line (crack crew) (17 pts) 

74 gun Ship of the Line (crack crew) (27 pts) 

74 gun Ship of the Line (average crew) (24 pts) 
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(f) Flamband 50 gun Ship of the Line (average crew) (14 pts) 

(f) Annibal 74 gun Ship of the Line (average crew) (24 pts) 

(f) Severe 64 gun Ship of the Line (average crew) (18 pts) 

(f) Brilliant 80 gun Ship of the Line (crack crew) (31 pts) 

(f) Sphinx 80 gun Ship of the Line (average crew) (27 pts) 

Nymphe vs. Cleopatre: 

Wind from the S, blowing a fresh breeze. 

(b) Nympbe 36 gun Frigate (crack crew) (11 pts) 

(f) Cleopatre 36 gun Frigate (average crew) (10 pts) 

Mars vs. Hercule: 

Wind from the S, blowing a fresh breeze. 

(b) Mara 74 gun Ship of the Line (crack crew) (26 pts) 

(f) Hercule 74 gun Ship of the Line (average crew) (23 pts) 

Ambuscade vs. Baionnabe: 

Wind from the N, blowing a fresh breeze. 

(b) Ambuscade 32 gun Frigate (average crew) (9 pts) 

(f) Baionnaise 24 gun Corvette (average crew) (9 pts) 

Constellation vs. Insurgent: 

Wind from the S, blowing a gale. 

(a) Constellation 38 gun Corvette (elite crew) (17 pts) 

(f) Insurgent 36 gun Corvette (average crew) (11 pts) 

Constellation vs. Vengeance: 

Wind from the S, blowing a fresh breeze. 

(a) Constellation 38 gun Corvette (elite crew) (17 pts) 

(f) Vengeance 40 gun Frigate (average crew) (15 pts) 

The Battle of Lissa: 

Wind from the S, blowing a fresh breeze. 

(b) Ampbion 32 gun Frigate (elite crew) (13 pts) 

(b) Active 38 gun Frigate (elite crew) (18 pts) 

(b) Volage 22 gun Frigate (elite crew) (11 pts) 

(b) Cerberus 32 gun Frigate (elite crew) (13 pts) 

(f) Favorite 40 gun Frigate (average crew) (15 pts) 

(f) Flore 40 gun Frigate (average crew) (15 pts) 

(f) Daaae 40 gun Frigate (crack crew) (17 pts) 

(f) Bellona 32 gun Frigate (green crew) (9 pts) 

(f) Corona : 40 gun Frigate (green crew) (12 pts) 

(f) Carolina ^ 32 gun Frigate (green crew) (7 pts) 

Constitution vs. Querriere; 

Wind from the blowing a gale. 

(a) Constitution 44 gun Corvette (elite crew) (24 pts) 

(b) Guerriere 38 gun Frigate (crack crew) (15 pts) 

United States vs. Macedonian: 

Wind from the S, blowing a fresh breeze. 
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(a) United States 44 gun Frigate (elite crew) (24 pts) 

(b) Macedonian 38 gun Frigate (crack crew) (16 pts) 

Constitution vs. Java: 

Wind from the S, blowing a fresh breeze. 

(a) Constitution 44 gun Corvette (elite crew) (24 pts) 

(b) Java 38 gun Corvette (crack crew) (19 pts) 

Chesapeake vs. Shannon: 

Wind from the S, blowing a fresh breeze. 


(a) Chesapeake 38 gun Frigate (average crew) (14 pts) 

(b) Shannon 38 gun Frigate (elite crew) (17 pts) 


The Battle of Lake Erie: 

Wind from the S, blowing a light breeze. 


(a) Lawrence 

(a) Niagara 

(b) Lady Prevost 
(b) Detroit 

(b) Q. Charlotte 


20 gun Sloop (crack crew) (9 pts) 
20 gun Sloop (elite crew) (12 pts) 
13 gun Brig (crack crew) (5 pts) 
19 gun Sloop (crack crew) (7 pts) 
17 gun Sloop (crack crew) (6 pts) 


Wasp vs. Reindeer: 

Wind from the S, blowing a light breeze. 


(a) Wasp 20 gun Sloop (elite crew) (12 pts) 

(b) Reindeer 18 gun Sloop (elite crew) (9 pts) 

Constitution vs. Cyane and Levant: 

Wind from the S, blowing a moderate breeze. 


(a) Constitution 44 gun Corvette (elite crew) (24 pts) 

(b) Cyane 24 gun Sloop (crack crew) (11 pts) 

(b) Levant 20 gun Sloop (crack crew) (10 pts) 

Pellew vs. Droits de L’Homme: 

Wind from the N; blowing a gale. 


(b) Indefatigable 
(b) Amazon 
(f) Droits L’Hom 


44 gun Frigate (elite crew) (14 pts) 

36 gun Frigate (crack crew) (14 pts) 

74 gun Ship of the Line (average crew) (24 pts) 


Algeciras: 

Wind from the SW, blowing a moderate breeze. 


(b) Caesar 
(b) Pompee 
(b) Spencer 
(b) Hannibal 
(s) Real-Carlos 
(s) San Fernando 
(s) Argonauta 
(s) San Augustine 
(f) Indomptable 
(f) Desaix 


80 gun Ship of the Line (crack crew) (31 pts) 

74 gun Ship of the Line (crack crew) (27 pts) 

74 gun Ship of the Line (crack crew) (^ pts) 

98 gun 3 Decker SOL (crack crew) (28 pts) 

112 gun 3 Decker SOL (green crew) (27 pts) 

96 gun 3 Decker SOL (green crew) (24 pts) 

80 gun Ship of the Line (green crew) (23 pts) 

74 gun Ship of the Line (green crew) (20 pts) 
80 gun Ship of the Line (average crew) (27 pts) 
74 gun Ship of the Line (average crew) (24 pts) 
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Lake Champlain: 

Wind from the N, blowing a fresh breeze. 

(a) Saratoga 26 gun Sloop (crack crew) (12 pts) 

(a) Eagle 20 gun Sloop (crack crew) (11 pts) 

(a) Ticonderoga 17 gun Sloop (crack crew) (9 pts) 

(a) Preble 7 gun Brig (crack crew) (4 pts) 

(b) Conflance 37 gun Frigate (crack crew) (14 pts) 

(b) Linnet 16 gun Sloop (elite crew) (10 pts) 

(b) Chubb 11 gun Brig (crack crew) (5 pts) 

Last Voyage of the USS President) 

Wind from the N, blowing a fresh breeze. 

(a) President 44 gun Frigate (elite crew) (24 pts) 

(b) Endymion 40 gun Frigate (crack crew) (17 pts) 

(b) Pomone 44 gun Frigate (crack crew) (20 pts) 

(b) Tenedos 38 gun Frigate (crack crew) (IS pts) 

Hornblower and the Natividad: 

Wind from the E, blowing a gale. 

A scenario for you Horny fans. Remember, he sank the Natividad against heavy odds and winds. 
Hint: don’t try to board the Natividad, her crew is much bigger, albeit green. 

(b) Lydia 36 gun Frigate (elite crew) (13 pts) 

(s) Natividad 50 gun Ship of the Line (green crew) (14 pts) 

Curse of the Flying Dutchman: 

Wind from the S, blowing a fresh breeze. 

iust for fun, take the Piece of cake. 

(s) Piece of Cake 2^ gun Corvette (average crew) (9 pts) 

(f) Flying Dutchy 120 gun 3 Decker SOL (elite crew) (43 pts) 

The South PaciSe: 

Wind from the S, blowing a strong breeze. 

(a) USS Scurvy 130 gun 3 Decker SOL (mutinous crew) (27 pts) 

(bj HMS Tahiti 120 gun 3 Decker SOL (elite crew) (43 pts) 

(s) Australian 32 gun Frigate (average crew) (9 pts) 

(f) Bikini Atoll 7 gun Brig (crack crew) (4 pts) 

Hornblower and the battle of Rosas 

Wind from the E, blowing a fresh breeze. 

The only battle Hornblower ever lost. He wu able to dismast one 
ship and stem rake another’s though. See if you can do as well. 

(b) Sutherland 74 gun Ship of the Line (crack crew) (26 pts) 

(f) Turenne 80 gun 3 Decker SOL (average crew) {27 pts) 

(f) Nightmare 74 gun Ship of the Line (average crew) (24 pts) 

(f) Paris 112 gUn 3 Decker SOL (green crew) (27 pts) 

(f) Napolean 74 gun Ship of the Line (green crew) (20 pts) 
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Cape Horn: 

Wind from the NE, blowing a strong breeze. 


(a) Concord SO gun Ship of the Line (average crew) (27 pts) 

(a) Berkeley 98 gun 3 Decker SOL (crack crew) (28 pts) 

(b) Thames 120 gun 3 Decker SOL (elite crew) (43 pts) 

(s) Madrid 112 gun 3 Decker SOL (green crew) (27 pts) 

(f) Musket 80 gun 3 Decker SOL (average crew) (27 pts) 

New Orleans: 

Wind from the SE, blowing a fresh breeze. 


Watch that little Cypress go! 

(a) Alligator 120 gun 3 Decker SOL (elite crew) (43 pts) 

(b) Firefly 74 gun Ship of the Line (crack crew) (27 pts) 

(b) Cypress 44 gun Frigate (elite crew) (14 pts) 

Botany Bay: 

Wind from the N, blowing a fresh breeze. 


(b) Shark 64 gun Ship of the Line (average crew) (18 pts) 

(f) Coral Snake 44 gun Corvette (elite crew) (24 pts) 

(f) Sea Lion 44 gun Frigate (elite crew) (24 pts) 

Voyage to the Bottom of the 

Wind from the NW, blowing a fresh breeze. 


This one is dedicated to David Hedison. 


(a) Seaview 

(a) Flying Sub 

(b) Mermaid 
(s) Giant Squid 


120 gun 3 Decker SOL (elite crew) (43 pts) 

40 gun Frigate (crack crew) (17 pts) 

136 gun 3 Decker SOL (mutinous crew) (27 pts) 
112 gun 3 Decker SOL (green crew) (27 pts) 


Frigate Action: 

Wind from the E, blowing a fresh breeze. 


(a) Killdeer 40 gun Frigate (average crew) (15 pts) 

(b) Sandpiper 40 gun Frigate (average crew) (15 pts) 

(s) Curlew 38 gun Frigate (crack crew) (16 pts) 

The Battle of Midway: 

Wind from the E, blowing a moderate breeze. 

(a) Enterprise 80 gun Ship of the Line (crack crew) (31 pts) 

(a) Yorktown 80 gun Ship of the Line (average crew) (27 pts) 
(a) Hornet 74 gun Ship of the Line (average crew) (24 pts) 

(f) Akagi 112 gun 3 Decker SOL (green crew) (27 pts) 

(f) Kaga 96 gun 3 Decker SOL (green crew) (24 pts) 

(f) Soryu 80 gun Ship of the Line (green crew) (23 pts) 

EXAMPLE OF MOVE: 

/ Max distance (including turns) 

/ Max number of 45 degree turns (one at a time only) 

/ / 

Move(3, 2): rll move right, sJiead, left 
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0 START 
b 


bO RIGHT 


bO ONE 


0 

b LEFT 


SAMPLE GAME: 

tatorisl% i»ll 
Choose a scenario: 


NUMBER SHIPS 

IN PLAY 

TITLE 

0): 2 

&o 

Ranger vs. Drake 

1): 2 

no 

The Battle of Flamborough Head 

2): 10 

no 

Arbuthnot and Des Touches 

3): 10 

no 

Suffren and Hughes 

4): 2 

no 

Nymphe vs. Cleopatre 

5): 2 

no 

Kbrs vs. Hercule 

6): 2 

no 

Ambuscade vs. Baionnaise 

7): 2 

no 

Constellation vs. Insurgent 

8): 2 

no 

Constellation vs. Vengeance 

0): 10 

no 

The Battle of Lissa 

10): 2 

no 

Constitution vs. Guerriere 

11): 2 

no 

United States vs. Macedonian 

12): 2 

no 

Constitution vs. Java 

13): 2 

no 

Chesapeake vs. Shannon 

14): 5 

no 

The Battle of Lake Erie 

15): 2 

no 

Wasp vs. Reindeer 

16): 3 

no 

Constitution vs. Cyane and Levant 

17): 3 

no 

Pellew vs. Droits de L’Homme 

18): 10 

no 

Algeciras 

19): 7 

no 

Lake Champlain 

20): 4 

no 

Last Voyage of the USS President 

21): 2 

no 

Hornblower and the Natividad 

22): 2 

no 

Curse of the Flying Dutchman 

23): 4 

no 

The South Pacific 

24): 5 

no 

Hornblower and the battle of Rosas bay 

25): 5 

no 

Cape Horn 

26): 3 

no 

New Orleans 

27): 3 

no 

Botany Bay 

28): 4 

no 

Voyage to the Bottom of the Sea 

29): 3 

no 

Frigate Action 

30): 6 

Scfijiiario number? SI 

no 

The Battle of Midway 
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Your ship is the Lydia, a 36 gun Frigate (elite crew). 

Your name, Captain? Dave #1 

Initial broadside left (grape, chain, round, double): d 

Initial broadside right (grape, chain, round, double): r 

Class 3 (36 guns) Frigate ’Lydia’ (bO) Points: 0 Fouls: 0 Grapples: 0 


! 

I 

~0 — a sinking ship | 

0 I 

b #1 — an exploding ship | 

I 

bow of Lydia |-1 

I wind speed >5+1 
I and direction | 

I (blowing from right) | 

! — a struck ship SO [..... - - - 1 

1 \ I 

stern of Natividad | 

Natividad has full sails set. | 

I 

- — . .Turn 0 .— - — — - 

Aye aye, Sir load: port and starboard • Load D! R! 0 1(1) 

Hull 9 \|/ 

crew: 3 sections — — Crew 4 4 2 -*-1(1) 
guns: port and starboard - Guns 4 4 /|\ 

carronades: port and starboard — Carr 2 2 | 3(5) 

rigging 4 masts - — Rigg 5 5 5 5 2(4) 
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NAME 

snake, snscoie - display chase game 
SYNOPSIS 

/usr/games/siiake [ -wn ] ( -In ] 

/uar/gamcs/snseore 

DESCRIPTION 

Snake is a display^based game which must be played on a CRT terminal from among those sup¬ 
ported by vi(l). The object of the game is to make as much money as possible without getting 
eaten by the snake. The -1 and -w options allow you to specify the length and width of the field. 
By default the entire screen (except for the last column) is used. 

You are represented on the screen by an I. The snake is 6 squares long and is represented by S’s. 
The money is $, and an exit is #. Your score is posted in the upper left hand corner. 

You can move around using the same conventions as vi(l), the h, j, k, and 1 keys work, as do the 
arrow keys. Other possibilities include: 

sefc These keys are like bjkl but form a directed pad around the d key. 

HJKL These keys move you all the way in the indicated direction to the same row or column as 

the money. This does not let you jump away from the snake, but rather saves you from 
having to type a key repeatedly. The snake still gets all his turns. 

SEFC Likewise for the upper case versions on the left. 

ATPB These keys move you to the four edges of the screen. Their position on the keyboard is 
the mnemonic, e.g. P is at the far right of the keyboard. 

X This lets you quit the game at any time, 
p Points in a direction you might want to go. 

w Space warp to get out of tight squeezes, at a price. 

I Shell escape 

‘Z Suspend the snake game, on systems which support it. Otherwise an interactive shell is 
started up. 

To earn money, move to the same square the money is on. A new | will appear when you earn 
the current one. As you get richer, the snake gets hungrier. To leave the game, move to the exit 
(#). 

A record is kept of the personal best score of each player. Scores are only counted if you leave at 
the exit, getting eaten by the snake is worth nothing. 

As in pinball, matching the last digit of your score to the number which appears after the game is 
worth a bonus. 

To see who wastes time playing snake, run futrfgametfenseore . 

FILES 

/usr/games/lib/snakerawscores database of personal bests 
/usr/games/lib/snake.log log of games played 

BUGS 

When playing on a small screen, it’s hard to tell when you hit the edge of the screen. 

The scoring function takes into account the size of the screen. A perfect function to do this equit¬ 
ably has not been devised. 
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NAME 

trek - trekkie game 


SYNOPSIS 

/usr/games/trek ( [ -a | file | 

DESCRIPTION 

Trek is a game of space glory and war. Below is a summary of commands. For complete docu¬ 
mentation, see Trek by Eric Allman. 

If a filename is given, a log of the game is written onto that file. If the —a flag is given before the 
filename, that file is appended to, not truncated. 

The game will ask you what length game you would like. Valid responses are “short”, 
“medium”, and “long”. You may also type “restart”, which restarts a previously saved game. 
You will then be prompted for the skill, to which you must respond “novice”, “fair”, “good”, 
“expert”, “commadore”, or “impossible”. You should normally start out with a novice and work 
up. 


In general, throughout the game, if you forget what is appropriate the game will tell you what it 
expects if you just type in a question mark. 


COMMAND SUMMARY 
abandon 
cloak up/down 
computer request; ... 
destruct 
hipip 
Irscan 

phasers automatic amount 

phasers manual amtl coursel spreadl ... 

torpedo course (yes) angle/no 

ram course distance 

shell j 

•rscan [yes/noj 

status 

undock 

warp warp_factor 


capture 

damages 

dock 

Impulse course distance 
move course distance 


rest time 
shields up/down 

terminate yes/no 
visual course 
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NAME 

worm - Play the growing worm game 
SYNOPSIS 

/usr/gamet/worm | tizc ] 

DESCRIPTION 

In worm, you are a little worm, your body is the ”o”’8 on the screen and your head is the ”0”. 
You move with the hjkl keys (as in the game snake). If you don't press any keys, you continue in 
the direction you last moved. The upper case keys move you as if you had pressed several 

(d for HL and 5 for JK) of the corresponding lower case key (unless you run into a digit, then it 
stops). 

On the screen you will see a digit, if your worm eats the digit is will grow longer, the actual 
amount longer depends on which digit it was that you ate. The object of the game is to see how 
long you can make the worm grow. 

The game ends when the worm runs into either the sides of the screen, or itself. The current 
score (how much the worm has grown) is kept in the upper left corner of the screen. 

The optional argument, if present, is the initial length of the worm. 

BUGS 

If the initial length of the worm is set to less than one or more than 75, various strange things 
happen. 


>4 
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NAME 

worms - animate worms on a display terminal 
SYNOPSIS 

/usr/games/worms [ -field | ( -length # | (-number # ] [ -trail ] 

DESCRIPTION 

Brian Horn (citheplbdh) showed me a TOPS-SO program on the DEC*2136 machine called 
WORM, and suggested that I write a similar program that would run under Unix. I did, and no 
apologies. 

-field makes a "field” for the worm(s) to eat; -tridl causes each worm to leave a trail behind it. 
You can figure out the rest by yourself. 

FILES 

/etc/termcap 

SEE ALSO 

Snaih, by Karl Heuer 

BUGS 

The lower-right-hand character position will not be updated properly on a terminal that wraps at 
the right margin. 

Terminal initialization is not performed. 
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NAME 

wump - the game of hunt-the-wumpus 

SYNOPSIS 

/ uar/gunw/wump 

DESCRIPTION 

Wump plays the game of 'Hunt the Wumpus.’ A Wumpus is a creatura that lives in a cave with 
several rooms connected by tunnels. You wander among the rooms, trying to shoot the Wumpus 
with an arrow, meanwhile avoiding being eaten by the Wumpus and fading into Bottomless Pits. 
There are also Super Bats which are likely to pick you up and drop you in some random room. 

The program asks various questions which you answer one per line; it will give a more detailed 
description if you want. 

This program is based on one described in People’s Computer Company, S, 2 (November 1973). 
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NAME 

mucellaneous - miscellaneous useful information pages 


DESCRffTION 

tl'his section contains miscellaneous documentation, mostly in the area of text processing macro 
^kages for trojB{l). 


ascii 

map of ASCn character set 

eqnchar 

special character definitions for eqn 

hier 

file system hierarchy 

mailaddr 

mail addressing description 

man 

macros to typeset manual pages 

me 

macros for formatting papers 

ms 

macros for formatting manuscripts 
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NAME 

ascii - map of ASCII character set 

SYNOPSIS 

cat /usr/pub/ascll 

DESCRIPTION 

Aecii is a map of the ASCII character set, to be printed as needed. It contains: 


000 

nul 

001 

BOh 

|002 

six 

003 

etx 

004 

eot 

|005 

enq 

006 

ack 

|007 

bei 

010 

bs 

oil 

ht 

joi2 

nl 

013 

vt 

014 

np 

|015 

cr 

016 

so 

j017 

si 

020 

die 

021 

del 

1022 

dc2 

023 

dc3 

024 

de4 

|025 

nak 

026 

syn 

1027 

etb 

030 

can 

031 

em 

j032 

sub 

033 

esc 

034 

fs 

|035 

88 

036 

rs 

|037 

us 

040 

sp 

041 

! 

1042 

n 

043 

# 

044 

1 

|045 

% 

046 

& 

1047 

# 

050 

( 

051 

) 

|052 

e 

053 

+ 

054 

t 

j055 

- 

056 

♦ 

j057 

/ 

060 

0 

061 

1 

|062 

2 

063 

3 

064 

4 

|065 

5 

066 

6 

1067 

7 

070 

8 

071 

9 

1072 

; 

073 

1 

074 

< 

|075 

■= 

076 

> 

j077 

t 

100 

Q 

101 

A 

|102 

B 

103 

c 

104 

D 

1105 

B 

106 

F 

jl07 

G 

110 

H 

111 

I 

jll2 

J 

113 

K 

114 

L 

jll5 

M 

116 

N 

jll7 

O 

120 

P 

121 

Q 

jl22 

R 

123 

S 

124 

T 

1125 

U 

126 

V 

jl27 

W 

130 

X 

131 

Y 

1132 

Z 

133 

I 

134 

\ 

jl35 

1 

136 


1137 


140 

% 

141 

a 

jl42 

b 

143 

c 

144 

d 

jl45 

e 

146 

f 

1147 

8 

150 

h 

151 

i 

jl52 

j 

153 

k 

154 

I 

jl55 

m 

156 

n 

jl57 

o 

160 

P 

161 

q 

jl62 

r 

163 

8 

164 

t 

jl65 

u 

166 

V 

jl67 

w 

170 

X 

171 

y 

1172 

t 

173 

{ 

174 

1 

1175 

} 

176 


jl77 

del 

00 

nul 

01 

soh 

il 02 

8tx| 

1 03 

etx 

04 

eot 

1 05 

enq 

06 

ack 

1 07 

bel 

08 

bs 

00 

ht 

Oa 

nl 1 

Ob 

vt 

Oe 

np 

j Od 

cr 

Oe 

so 

1 Of 

si 

10 

die 

11 

del 

12 

de2| 13 

dc3 

14 

dc4 

[| 15 

nak 

16 

syn 

i| 17 

etb 

18 

can 

19 

em 

1 la 

subj lb 

esc 

Ic 

fs 

1 Id 

88 

le 

rs 

i ff 

us 

20 

sp 

21 

» 

1 22 

ff 

23 

# 

24 

1 

1 25 

% 

26 

& 

1 27 

* 

28 

( 

29 

) 

I 2a 

m 

2b 

+ 

2c 

f 

j 2d 

- 

2e 

• 

1 2f 

1 

30 

0 

31 

1 

1 32 

2 

33 

3 

34 

4 

j 35 

5 

36 

6 

1 37 

7 

38 

8 

39 

9 

3a 

: 

3b 

f 

3e 

< 

3d 

a 

3e 

> 

3f 

? 

40 

0 

41 

A 

1 

B 

43 

C 

44 

D 

45 

E 

46 

F 

1 47 

G 

48 

H 

49 

I 

1 4a 

J 

4b 

K 

4e 

L 

1 dd 

M 

4e 

N 

4f 

O 

50 

P 

51 

Q 

1 52 

R 

53 

S 

54 

T 

j 55 

U 

56 

V 

1 57 

W 

58 

X 

59 

Y 

1 5a 

Z 

5b 

I 

5c 

\ 

1 5d 

1 

5e 

A 

1 5f 


60 

a 

61 

a 

1 62 

b 

63 

c 

64 

d 

j 65 

e 

66 

f 

1 67 

8 

68 

h 

69 

i 

1 6a 

i 

6b 

k 

6c 

1 

6d 

m 

6e 

n 

1 Of 

o 

70 

P 

71 

q 

72 

r 

73 

8 

74 

t 

1 75 

u 

76 

V 

1 77 

w 

78 

X 

79 

y 

1 7a 

2 

7b 

{ 

7c 

! 

1 7d 

} 

7e 


1 7f 

del 


FILES 

/usr/pub/ascii 
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EQNCHAR(7) 


TABLES 


EQNCHAR(7) 


NAME 

eqBchar - special character definitions for eqn 
SYNOPSIS 

eqn /usr/pub/e<paehar ( files 11 trolf ( options ] 
neqn /usr/pub/eqnehar [ files ] | nroff [ options ] 

DESCRIPTION 

Eqnchar contains troff and nroff character definitions for constructing characters that are not 
available on the Graphic Systems typesetter. These definitions are primarily intended for use 
with eqn and neqn. It contains definitions for the following characters 


eiplue 


li 

11 

square 


citimee 

0 

langU 


circle 

o 

mg 


rangle 

) 

blot 


•wig 

Cat 

hbar 

ft 

bullet 

• 

>wig 


ppd 

4. 

prop 


<wig 


<•> 

4-b 

empty 

0 

tsKwig 


<-> 


member 

€ 

etar 

* 

i< 

< 

nomem 

i 

bigttar 

* 

i> 

> 

cup 

u 

mcdot 

— 

ang 

L 

cap 

n 

ortign 

V 

rang 

1- 

incl 

C 

miaign 

A 

Sdot 


subset 

c 

^det 

A 

S3 

thf 


supset 

D 

oppA 

V 

quarter 


fsubset 

C 

oppE 

3 

Squarter 


/supset 

D 

angttrom 

A 

degree 

« 




FILES 

/usr/pub /eqnchar 

SEE ALSO 

troff(l), eqn(l) 
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NAME 

hier - file system hierarchy 
DESCRIPTION 

The following outline gives a quick tour through a representative directory hierarchy. 

/ root 
/vmunix 

the kernel binary (UNIX itself) 

/lo6t+ found 

directory for connecting detached files for 
/dev/ devices^ see section 4 

console main console, tty(4) 
tty* terminals, <ly(4) 

xy* disks, jy(4S) 

rxy* raw disks, xy(4S) 

• • • 

/bin/ utility programs, cf /usr/bin/ (described in sect. 1) 
as assembler 

cc C compiler executive, cf /lib/ccom, /lib/cpp, /lib/c2 

csh C shell 

• • • 

/lib/ object libraries and other stuff, cf /usr/lib/ 

libc.a system calls, standard I/O, etc. (described in sect. 2, 3, 3S, 3C, 3N) 

• 0 • 

ccom C compiler proper 

cpp C preprocessor 

c2 C code improver 

• • • ' 

/etc/ essential data and maintenance utilities; described in section 8 
dump dump program dump (8) 
passwd password file, passu;d(5) 
group group file, group{b) 
motd message of the day, iogin{l) 
termcap 

description of terminal capabilities, termcap(b) 
tty type table of what kind of terminal is on each port, ttytypt(h) 
mtab mounted file table, mtab(S) 
dumpdates 

dump history, dump(8) 

fstab file system configuration table f8tab(b) 
ttys properties of terminals, <^2/s(5) 

getty part of login, getty{S) 

init the parent of all processes, init{S) 
rc shell script to bring the system up 
cron the clock daemon, cron(8) 
mount mount(Z) 

wall u;a//(l) 

• • • 

/tmp/ temporary files, cf /usr/tmp/ 
e* used by ed(l) 

ctm* used by cc(l) 

• • • 

/usr/ general-pupose directory, usually a mounted file system 
adm/ administrative information 
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wtmp login history, u{mj>(5) 
messages 

hardware error messages 
bin/ utility programs, to keep /bin/ small 
etc/ administrative programs, to keep /etc/ small 
tmp/ temporaries, to keep /tmp/ small 
stm* used by sor((l) 
diet/ word lists, etc. 

words principal word list, used by look{l) 
spellbist 

history file for $peU(l) 

games/ 

hangman 

lib/ library of stuff for the games 
quiz.k/ what quit{6) knows 

index category index 
africa countries and capitals 


• • • 

include/ 

standard #include files 
a.out.b object file layout, a.out(5) 
stdio.h standard I/O, sfdto(3S) 
math.h (3M) 

sys/ system^defined layouts, cf /sys/h 
lib/ object libraries and stuff, to keep /lib/ small 
atrun scheduler for a^(l) 
lint/ utility IBles for lint 

lint[12] subprocesses for 

llib-lc dummy declarations for /lib/libc.a, used by /m<(l) 
llib-lm dummy declarations for /lib/libc.m 

• • • 

struct/ passes of s(rue/(l) 

• • • 

tmac/ macros for troJff{l) 
tmac.an 

macros for mon(7) 
tmac.s macros for ms(7) 

• • • 

font/ fonts for troff{l) 

ftR Times Roman 

ftB Times Bold 

• • • 

uucp/ programs and data for uttcp(lC) 

L.sys remote i^stem names and numbers 
uucico the real copy program 

. * * * 

units . conversion tables for 

eign list of English words to be ignored by ptx{l) 
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/usr/ man/ 

Pages for major manuals — Veer’s Guide to Commands, UNIX Programmer’s Manual, 
uad System Manager’s Guide, man(l) 
manO/ general 

intro introduction to Sun System Manuals, in ms{7) format 
XX template for manual page 
manl/ chapter 1 
as.l 

spline. Ig 

• • • 

• • • 

catl/ preformatted pages for section 1 

• • ■' 

preserve/ 

editor temporaries preserved here after crashes/hangups 
spool/ delayed execution files 
at/ used by ai(l) 

Ipd/ used by /pr(l) 

lock present when line printer is active 
cf* copy of file to be printed, if necessary 
df* daemon control file, lpd(8) 
tf* transient control file, while Ipr is working 
uucp/ work files and staging area tor uucp(lC) 

LOGFILE 

summary log 

LOG.* log file for one transaction 

• • • 

mail/ mailboxes for matl{l) 

name mail file for user name 
nameAock 

lock file while name is receiving mail 

secretmail/ 

like mail/ 

wd initial working directory of a user, typically wd is the user's login name 
•profile set environment for sA(l), cnw>an(5) 

•cshrc startup file for csA(l) 

•exrc startup file for ez(l) 

•mailrc startup file for mat7(l) 
calendar 

user's datei^ook for ca(endar(l) 

ucb/ 

binaries of programs developed at University of California at Berkeley. 

• • • 

edit editor for beginners 

ek command editor for experienced users 

• • • 

mail mail reading/sending subsystem 
man on line documentation 
• • • 

pi Pascal translator 

px Pascal interpreter 

• • • 

vi visuad editor 
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S£C ALSO 

wbati8(l), wherei8(l), which (1), ncheck(8), find(l), grep(l) 

BUGS 

The position of files is subject to change without notice. 
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NAME 

mailaddr - mail addressing description 
DESCRIPTION 

Mail addresses are based on the ARPANET protocols listed at the end of this manual page. 
These addresses are in the general format 

userQdomain 

where a domain is a hierarchical dot separated list of subdomains. For example, the address 
ericQmonet.Berkeley.ARPA 

is normally interpreted from right to left: the message should go to the ARPA name tables (which 
do not correspond exactly to the physical ARPANET), then to the Berkeley gateway, after which 
it should go to the local host monet. When the message reaches monet it is delivered to the user 
“eric”. 

Unlike some other forms of addressing, this does not imply any routing. Thus, although this 
address is specified as an ARPA address, it might travel by an alternate route if that was more 
convenient or efficient. For example, at Berkeley the associated message would probably go 
directly to monet over the Ethernet rather than going via the Berkeley ARPANET gateway. 

Abbreviation. Under certain circumstances it may not be necessary to type the entire domain 
name. In general anything following the first dot may be omitted if it is the same as the domain 
from which you are sending the message. For example, a user on “calder Berkeley .ARPA” could 
send to “ericOmonet” without adding the “Berkeley.ARPA” since it is the same on both sending 
and receiving hosts. 

Certain othei^ abbreviations may be permitted as special cases. For example, at Berkeley 
ARPANET hosts can be referenced without adding the “.ARPA” as long as their names do not 
conflict with a local host name. 

Compatibility. Certain old address formats are converted to the new format to provide 
compatibility with the previous mail system. In particular, 

hoet:u8er 

is converteci to 

userQhost 

to be consistent with the rep (1C) command. 

Also, the syntax: 

hostiuser 

is converted to: 

userObost.UUCP 

This is normally converted back to the “hostiuser” form before being sent on for compatibility 
with older UUCP hosts. 

The current implementation is not able to route messages automatically through the UUCP 
network. This feature is planned for the 4.2 release. Until that time you must explicitly tell the 
mail system which hosts to send your message through to get to your final destination. 

Caee Distinctions. Domain names (i.e., anything after the “Q” sign) may 1>e given in any mixture 
of upper and lower case with the exception of UUCP hostnames. Most hosts accept any mixture 
of case in user names, with the notable exception of MULTICS sites. 

Differences with ARPA Protocols. Although the UNIX addressing scheme is based on the ARPA 
mail addressing protocols, there are some significant differences. 
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At the time of this writing the only “top lever* domain defined by ARPA is the “.ARPA“ 
domain itself* This is further restricted to having onb^ one level of host specifier. That is, the 
only addresses that ARPA accepts at this time must be in the format “userQbostARPA” (where 
“h«t“ is one word). In particular, addresses such as: 

ericOmonet.Berkeley.ARPA 

are not currently legal under the ARPA protocob. For thb reason, these addresses are converted 
to a different format on output to the ARPANET, typically: 

eric%monetOBerkeley .ARPA 

Routt-addrs. Under some circumstances it may be necessary to route a message through several 
hosts to get it to the final destbation. Normally thb routing b done automatically, but 
sometimes it is desirable to route the message manually. An address that shows these relays are 
termed “route-addrs.** These use the syntax: 

< Qhosta,<lho8tb:u8er<lhostc > 

Thb specifies that the message should be sent to hosta, from there to hostb, and finally to hostc. 
Thb path is forced even if there is a more elHcient path to hostc. 

Route-addrs occur frequently on return addresses, since these are generally augmented by the 
software at each host. It b generally possible to ignore all but the “userOhost** part of the 
address to determine the actual sender. 

Po$ima$ter. Every site b required to have a user or user alias designated “postmaster** to which 
problems with the mail system may be addressed. 

CSNET. Messages to CSNET sites can be sent to **user.ho6tQUDel-Relay*’. 

BERKELEY 

The following comments apply only to the Berkeley environment. 

Ho$t Names. Many of the old familiar host names are being phased out. In particular, single 
character names as used in Berknet are incompatible with the larger world of which Berkeley is 
now a member. For thb reason the following names are being obsoleted. You should notify any 
correspondents of your new address as soon as possible. 

OLD NEW j ingvax 

p ucbcad r arpavax 

V csvax ucbernie 

n ucbkim y 

The old addresses will be rejected as unknown hosts sometime in the near future. 

What's My Address? If you are on a local machine, say monet, your address is 
yournameOmonet.Berkeley.ARPA 

However, since most of the world does not have the new software in place yet, you will have to 
give correspondents slightly different addresses. From the ARPANET, your address would be: 

yourname%monetQBerkeley.ARPA 
From UUCP, your address would be: 

ucbvaximonet.yourname 

Computer Center. The Berkeley Computer Center is in a subdomain of Berkeley so that they may 
adminbter their own name space. Messages to the computer center should be addressed to one of: 

userQhost.CC.Berkeley.ARPA 

uscr%ho8t.CCOBerkeley.ARPA 


ucbingres 

ucbarpa 

ucbcory 
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depending on where the message is being sent from. The “.Berkeley.ARPA” may be omitted if 
the message is sent from inside Berkeley. 

For the time being Computer Center hosts are known within the Berkeley domain, i.e., the ‘*.CC” 
is optional. However, it is likely that this situation will change with time as both the Computer 
Science department and the Computer Center grow. 

Bitnet. Hosts on bitnet may be accessed using: 

userQho6t.BITNET 
This works from 4.2 machines. 
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NAME 

man - macros to typeset manual 

SYNOPSIS 

aroff -man file ... 

troff -mam file ... 

DESCRIPTION 

These macros are used to lay out pages of this manual. A skeleton page may be found in the file 
/usr/man/manO/xx. 

Any text argument t may l)e cero to six words. Quotes may be used to include blanks in a 
'word’. If Usi is empty, the special treatment is applied to the next input line with text to be 
printed. In this way .1 m^ be used to italicize a whole line, or .SM followed by 3 to make small 
bold letters. 

A prevailing indent distance is remembered between successive indented paragraphs, and is reset 
to default value upon reaching a non*iadented paragraph. Default units for indents i are ens. 

Type font and size are reset to default values before each paragraph, and after processing font 
and size setting macros. 

These strinp are predefined by -rann: 

\*R * ’, '(Reg)’ in nroff. 

\*S dhange to default type size. 

FILES 

/usr/lib/tmae/tmae.an 
/uir/man/manO/xx 

SEE ALSO 

trofl(l), man(l) 

BUGS 

Relative indents don't nest. 

REQUESTS 


Re<iuest 

Cause If no 
Break Argument 

Explanation 

.B i 

no 

l-n.t.l.* 

Text 1 is bold. 

.BIf 

BO 


Join words of 1 alternating bold and italic. 

.BR t 

BO 

I*n.t.l. 

Join words of I alternating bold and Roman. 

.DT 

BO 

.5i li... 

Restore default tiibs. 

.HPi 

yes 

6-p.i.* 

Set prevailing indent to t. Begin paragr^h with hanging indent. 

.11 

BO 

l■•n.t.I. 

Text 1 is italic. 

.SI 

BO 

lian.t.l. 

JoiB words of t alternating italic and bold. 

.Set' 

yes 


Same as .TP with ts| e. 

.IR 1 

BO 

liBn.t.l. 

Joii| words of 1 alternating italic and Roman. 

.LP 

yea 

- 

Same as .PP. 

.PD i 

BO 

d"».4v 

Interparagraph distance is d. 

.PP 

yei 

- 

Begin paragraph. Set prevailing indent to .5i. 

.RE 

yei 

- 

End of relative indent. Set prevailing indent to amount of starting .RS. 

.RBI 

BO 


Join words of 1 alternating Roman and bold. 

.RII 

BO 


Join words of 1 alternating Roman and italic. 

.RS t 

yes 

r=«p.i. 

Start relative indent, move left margin in distance t. Set prevailing indent 
to .5i for nested indents. 

.SH 1 

yes 


Subhead. 

.SM 1 

BO 

<=o.t.L 

Text I is small. 

.TH » e 

X V myes 

- 

Begin page named n of chapter c; x is extra commentary, e.g. ‘local’, for 
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page foot center; v alters page foot left, e.g. ‘4th Berkeley Distribution'; tn 
alters page bead center, e.g. ‘Brand X Programmer’s Manual’. Set 
prevailing indent and tabs to .5i. 

.TP t yes ^p.i. Set prevailing indent to t. Begin indented paragraph with hanging tag 

given by next text line. If tag doesn’t fit, place it on separate line. 

* n.t.l. next text line; p.i. » prevailing indent 
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NAME 

me - macros for formatting papers 
SYNOPSIS 

oroff-m* I options ] file ... 
troff-m* ( options ] file ... 

DESCRIPTION 

This package of nroff and troff macro definitions provides a canned formatting facflity for tech* 
nical papers in various formats. When producing 2-column output on a terminal, filter the output 
through ee/(l). 

The macro requests are defined below. Many nroff and troff requests are unsafe in conjunction 
with this package, however these requests may be used with impunity after the first .pp: 


.bp 

begin new page 

.br 

break output line here 

.sp n 

insert n spacing lines 

.Is n 

(line spacing) nal single, nB'2 double space 

.na 

no alignment of right margin 

.ee a 

center next n lines 

.ul n 

underline next n lines 

.ss -1-n 

add n to point size 


Output of the eqn, neqn, refer, and <5/(l) preprocessors for equations and tables is acceptable as 
input. 

FILES 

/u8r/lib/tmi((^tmac.e 

/usr/lib/me/* 

SEE ALSO 

eqn(l), troff(l), refer(l), tbl(l) 

-me Reference Manual, Erie P. Allman 
Writing Papers with Nroff Using -me 

REQUESTS 

In the following list, ’Initializatioo’’ refers to the first .pp, .Ip, .ip, .np, .sh, or .uh macro. This 
list is incomplete; see The -me Reference Manual tot interesting details. 


Request Initial Cause Explanation 

Value Break 

•(« 

yes 

Begin centered block 

.(d - 

no 

Begin delayed text 

.(f 

no 

Begin footnote 

.(1 

yes 

Begin list 

.(q 

yes 

Bogin mnior quote 

.(x a 


Begin indexed item in index x 

.(« 

nb 

Begin floating keep 

.)« 

yes 

End centered block 


yes 

End delayed text 

.)f 

yes 

End footnote 

.)l 

y«» 

End list 

•h 

yes 

End major quote 

•)x 

yes 

End index item 

•)» 

yes 

End floating keep 

.+ + m H - 

no 

Define paper section, m defines the part of the paper, and can be C (chapter), A 
(appendix), P (preliminary, e.g., abstract, table of contents, etc.), B 


(biblbgraphy), RC (chapters renumbered from page one each chapter), or RA 
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(appendix renumbered from page one), 

c r - yes Begin chapter (or appendix, etc., as set by .+ +). T is the chapter title. 

.Ic 1 yes One column format on a new page. 

,2c 1 yes Two column format. 

.EN - yes Space after equation produced by tqn or neqn. 

.EQ xy • yes Precede equation; break out and add space. Equation number is y. The optional 

argument x may be / to indent equation (default), L to left-adjust the equation, 
or C to center the equation. 

.TE - yes End table. 

,TH • yes End heading section of table. 

.TS X • yes Begin table; if x is H table has repeated heading. 

,zc A N • no Set up for ACM style output. A is the Author's name(8), N is the total number 

of pages. Must be given before the first initialization. 

.b X no no Print x in boldface; if no argument switch to boldface. 

.ba n 0 yes Augments the base indent by n. This indent is used to set the indent on regular 

text (like paragraphs). 

.be no yes Begin new column 

.bi X no no Print x in bold italics (nofill only) 

.bx X no no Print x in a box (nofill only). 

.ef ^x'y'z'^ no Set even footer to x y z 

.eh ^x*y*z' "" no Set even header to x y z 

,to 'x'y^z' "" no Set footer to x y z 

.hx - no Suppress headers and footers on next page. 

.he "x no Set header to x y z 

.hi • yes Draw a horizontal line 

.i X no no Italicize x; if x missing, italic text follows. 

.ip z y no yes Start indented paragraph, with banging tag x. Indentation is y ens (default 5). 

.Ip yes yes Start left-blocked p 2 iragraph. 

.lo - no Read in a file of local macros of the form .^x. Must be given before 

initialization. 

.np 1 yes Start numbered paragraph. 

.of 'x'y*z' no Set odd footer to x y z 

.oh 'x'y^z* "" no Set odd header to x y z 

.pd - yes Print delayed text, 

.pp no yes Begin paragraph. First line indented. 

.r yes no Roman text follows. 

.re •• no Reset tabs to default values. 

.sc no no Read in a file of special characters and diacritical marks. Must be given before 

initialization. 

.sh n X - yes Section head follows, font automatically bold, n is level of section, x is title of 

sectiop. 

.sk no nd Leave the next page blank. Only one page is remembered ahead. 

.sz n lOp no Augment the point size by n points. 

.th no no Produce the paper in thesis format. Must be given before initialization. 

,tp no yes Begin title page. 

•u X - no Underline argument (even in (Nofill only). 

.uh • yes Like .sh but unnumbered. 

.xp X - no Print index x. 
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NAME 

ms - text fonnatting macros 
SYNOPSIS 

nroff -ms ( options ] file ... 
troff -ms ( options ) file ... 

DESCRIPTION 

This package of nroff and troff macro definitions provides a formatting facility tor various styles 
of articles, theses, and books. When producing 2-column output on a terminal or lineprinter, or 
when reverse line motions are needed, filter the output through col(l). All external -ms macros 
are defined below. 

Note that this -ms macro package is an extended version written at Berkeley and is a superset of 
the standard - ms macro packages as supplied by Bell Labs. Some of the Bell Labs macros have 
been removed, for instance, it is assumed that the user has little interest in producing headers 
stating that the memo was generated at Whippany Labs. 

Many nroff and troff requests are unsafe in conjunction with this package. However, the first 
four requests below may 1^ used with impunity after initialization, and the last two may be used 
even before initialization: 

.bp begin new page 

.br breaJi output line 

.sp n insert n spacing lines 

.ce n center next n lines 

.Is n line spacing: nal single, ns=2 double space 
.na no alignment of right margin 

Font and point size changes with \f and \8 are also allowed; for example, “\fIword\fR” will 
italicize word. Output of the tbl{l), e9n(l) and re/er(l) preprocessors for equations, tables, and 
references is acceptable as input. 

FILES 

/usr/lib/tmac/tmac .8 
/u8r/lib/m8/ms.Tff 

SEE ALSO 

eqn(l), refer(l), tbl(l), troff(l) 

Formatting Doeumento with the ~m$ Macro Package in 
Editing and Text Proeeoeing on the Sun Workotation and the 
Beginner’» Guide to the Sun Worketation. 

REQUESTS 


11 

Initial 

Value 

Break? 

Reset? 

Explanation 

.AP* 


y 

begin abstract; if xs=no don’t label abstract 

.AE 

- 

y 

end abstract 

•AI 

- 

y " 

author’s institution 

.AM 

- 

n 

better accent mark definitions 

.AU 

- 

y 

author’s name 

.Be 

— 

n 

embolden x; if no x, switch to boldface 

.B1 

- 

y 

begin text to be enclosed in a box 

.B2 

- 

y 

end boxed text and print it 

.BT 

date 

n 

bottom title^ printed at foot of page 

.BX* 

- 

n 

print word x in a box 

.CM 

ift 

n 

cut mark between pages 

•CT 

- 

y,y 

chapter title: page number moved to CF (TM only) 

.DA* 

if n 

n 

force date x at bottom of page; today if no x 
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.DE 

— 

y 

end display (unfilled text) of any kind 

.DS X y 

I 

y 

begin display with keep; ««=I,L,C,B; y=sindent 

.ID y 

Sn,,bi 

y 

indented display with no keep; y=indent 

.LD 

— 

y 

left display with no keep 

.CD 

— 

y 

centered display with no keep 

.BD 

- 

y 

block display; center entire block 

.EF X 

— 

n 

even page footer x (3 part as for .tl) 

.EH X 

- 

n 

even page header x (3 part as for .tl) 

.EN 

- 

y 

end displayed equation produced by eqn 

.EQ X y 

— 

y 

break out equation; x=^LX^l p^equation number 

.FE 

— 

n 

end footnote to be placed at bottom of page 

.FP 

— 

n 

numbered footnote paragraph; may be redefined 

.FS X 

— 

n 

start footnote; x is optional footnote label 

.HD 

undef 

n 

optional page header below header margin 

.1 X 

— 

n 

italicize x;it no x, switch to italics 

.IP xy 

— 

y^y 

indented p 2 uragraph, with hanging tag x; yssindent 

.DC X y 

- 

y 

index words x y and so on (up to 5 levels) 

.KE 


n 

end keep of any kind 

.KF 


n 

begin floating keep; text fills remainder of page 

.KS 

- 

y 

begin keep; unit kept together on a single page 

.LG 

- 

n 

larger; increase point size by 2 

.LP 

- 

yj 

left (block) paragraph. 

.MC X 

- 

y^y 

multiple columns; x»column width 

.ND X 

ift 

n 

no date in page footer; x is date on cover 

.NHxy 

- 

y,y 

numbered header; x«slevel, x^O resets, x^S sets to y 

.ML 

lOp 

n 

set point size back to normal 

.OF X 

- 

n 

odd page footer x (3 part as for .tl) 

.OHx 

- 

n 

odd page header x (3 part as for .tl) 

.PI 

if TM 

n 

print header on 1st page 

.PP 

- 

yj 

paragraph with first line indented 

.PT 

- . 

n 

page title, printed at head of page 

.PXx 

- 

y 

print index (table of contents); x^no suppresses title 

QP 

- 

y^y 

quote paragraph (indented and shorter) 

.R 

on 

n 

return to Roman font 

.RE 

5n 

y,y 

retreat: end level of relative indentation 

.RP X 

- 

n 

released paper format; x«no stops title on Ist page 

.RS 

5n 

yj 

right shift: start level of relative indentation 

.SH 

- 

y,y 

section header, in boldface 

.SM 

- 

n 

smaller; decrease point size by 2 

.TA 

8n,5n 

n 

set tabs to 8n 16n ... (nroff) 5n lOn ... (troff) 

.TC X 

- 

y 

print table of contents at end; xs=no suppresses title 

.TE 

- 

y 

end of table processed by tbl 

.TH 


y 

end multi-page header of table 

.TL 


y 

title in boldface and two points larger 

.TM 

off 

n 

UC Berkeley thesis mode 

.TS X 


y,y 

begin table; if x^H table has multi-page header 

.UL X 

- 

n 

underline x, even in troff 

.UX X 

- 

n 

UNIX; trademark message first time; x appended 

.XA X y 

- 

y 

another index entry; x=page or no for none; p=iindent 

.XE 

- 

y 

end index entry (or series of .DC entries) 

.XP 

- 

y,y 

paragraph with first line exdented, others indented 

■XS xy 

- 

y 

begin index entry; xs=page or no for none; ys^sindent 

.1C 

on 

y,y 

one column format, on a new page 
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MS (7) 


TABLES 


MS(7) 


.2C - y,y begin two colttmn format 

B beginning of refer reference 

B end of unclassifiable type of reference 
n N«b l:journaI>articIe, 2;book, 3:book-article, 4:report 


Svn Release 1.1 
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MS (7) 


TABLES 


MS(7) 


REGISTERS 

Formatting distances can be controlled in -ms by means of built-in number registers. For 
example, this sets the line length to 6.5 inches: 

.nr LL 6.5i 

Here is a table of number registers and their default values: 


Name 

Register Controls 

Takes Effect Default 

PS 

point size 

paragraph 

10 

VS 

vertical spacing 

paragraph 

12 

LL 

line length 

paragraph 

6i 

LT 

title length 

next page 

same as LL 

FL 

footnote length 

next .FS 

5.5i 

PD 

paragraph distance 

paragraph 

Iv (if n), .3v (if t) 

DD 

display distance 

dkplays 

Iv (if n), .5v (if t) 

PI 

paragraph indent 

paragraph 

5n 

QI 

quote indent 

next .QP 

5n 

FI 

footnote indent 

next .FS 

2n 

PO 

page offset 

next page 

0 (if n), ~li (if t) 

HM 

header margin 

next page 

li 

FM 

footer margin 

next page 

li 

FF 

footnote format 

next .FS 

0 (1, 2, 3 available) 


When resetting these values, mdce sure to specify the appropriate units. Setting the line length 
to 7, for example, will result in output with one character per line. Setting FF to 1 suppresses 
footnote superscripting; setting it to 2 ako suppresses indentation of the first line; and setting it 
to 3 produces an .IP-like footnote paragraph. 

Here is a list of string registers available in -ms; they may be used anywhere in the text: 


Name 

Sitring’s Function 

\*Q 

quote (” in nroff, “ in troff) 

\*u 

unquote (” in nroff, ” in troff) 

\*- 

dash (— in nroff, — in troff) 

\*(MO 

month (month of the year) 

\*(DY 

day (current date) 


automatically numbered footnote 


acute accent (before letter) 

\*‘ 

grave accent (before letter) 

\** 

circumflex (before letter) 

\*. 

cedilla (before letter) 

\*: 

umlaut (before letter) 

\*- 

tilde (before letter) 


When using the extended accent mark definitions available with .AM, these strings should come 
after, rather than before, the letter to be accented. 

BUGS 

Floating keeps and regular keeps are diverted to the same space, so they cannot be mixed 
together with predictable results. 
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